Kontrolelementet Kombinationsfelt i Power Apps
Et kontrolelement, der gør det muligt for brugerne at vælge mellem de angivne valgmuligheder. Understøtter søgning og flere markeringer.
Beskrivelse
Kontrolelementet Kombinationsfelt gør det muligt at søge efter elementer, som du vil vælge. Søgningen udføres på serversiden for egenskaben SearchField, så ydeevnen ikke påvirkes af store datakilder.
Tilstanden Enkelt valg eller Flere valg konfigureres via egenskaben SelectMultiple.
Når der søges efter elementer, der skal vælges, kan du for hvert element vælge at få vist en enkelt dataværdi, to værdier eller et billede og to værdier (Person) ved at redigere layoutindstillingerne i dataruden.
Når du ser på små skærme, bliver pop op-vinduet med elementlisten en fuld skærm for at opnå større anvendelighed.
Bemærk
Hvis du vil søge efter elementer med tal, skal du konvertere tal til tekst med funktionen Text (). For eksempel Text(12345).
Begrænsninger
Kontrolelementet Kombinationsfelt har følgende begrænsninger:
- Når du bruger et kontrolelement af typen Kombinationsfelt i et galleri, bevares markeringerne ikke, når brugeren ruller gennem galleriet. Det er ikke et problem, hvis du bruger et kontrolelement af typen Kombinationsfelt i et galleri, hvor der ikke kan rulles. Der findes i øjeblikket ikke en løsning.
Personvælger
Hvis du vil bruge Kombinationsfelt som personvælger, skal du vælge skabelonen Person i Layoutindstillinger i ruden Data og konfigurere egenskaberne for de relaterede data, der skal vises personen nedenfor.
Vigtige egenskaber
Items – Den datakilde, hvorfra kan foretages valg.
DefaultSelectedItems – Det eller de først valgte elementer, før en bruger arbejder med kontrolelementet.
Bemærk
Default-egenskaben er frarådet - brug i stedet DefaultSelectedItems.
SelectedItems – En liste over valgte elementer som følge af brugerinteraktion.
SelectMultiple – Om brugeren kan vælge et enkelt element eller flere elementer.
IsSearchable – Om brugeren kan søge efter elementer, før der foretages et valg.
Bemærk
IsSearchable kan kun aktiveres på en datakilde, der indeholder mindst ét tekstfelt. Udtrykket Items skal uddelegeres, for at forespørgsler kan uddelegeres til søgning. Det vil sige, at If-sætninger i udtrykket Items ikke understøttes.
SearchFields – Der søges i datafelterne for datakilden, når brugeren angiver tekst.
Bemærk
Hvis du vil søge i flere felter, skal du angive egenskaben SearchFields i dette format: ["MyFirstColumn", "MySecondColumn"]. Kun tekstfelter understøttes.
Flere egenskaber
AccessibleLabel – Etiket for skærmlæsere.
BorderColor – Farven på et kontrolelements kant.
BorderStyle – Om et kontrolelements kant er Solid, Dashed, Dotted eller None.
BorderThickness – Tykkelsen på et kontrolelements kant.
DisplayFields – En liste over de felter, der vises for hvert element, der returneres af søgningen. Den er lettest at konfigurere indstillingerne via ruden Data på fanen Egenskaber.
Bemærk
Hvis du vil opdatere flere visningsfelter i en bestemt skabelon, skal du angive egenskaben DisplayFields i dette format: ["MyFirstColumn", "MySecondColumn"].
DisplayMode – Om kontrolelementet tillader brugerinput (Edit), kun viser data (View) eller er deaktiveret (Disabled).
FocusedBorderColor – Farven på et kontrolelements kant, når kontrolelementet er i fokus.
FocusedBorderThickness – Tykkelsen på et kontrolelements kant, når kontrolelementet er i fokus.
Height – Afstanden mellem et kontrolelements øverste og nederste kant.
InputTextPlaceholder – Vejledende tekst, der vises for slutbrugerne, når der ikke er valgt nogen elementer.
OnChange – Handlinger, der skal udføres, når brugeren ændrer et valg.
OnNavigate – Handlinger, der skal udføres, når brugeren vælger et element.
OnSelect – Handlinger, der skal udføres, når brugeren trykker på eller vælger et kontrolelement.
TabIndex – Rækkefølgen for tastaturnavigationen i forhold til andre kontrolelementer.
Visible – Om et kontrolelement vises eller skjules.
Width – Afstanden mellem et kontrolelements venstre og højre kant.
X – Afstanden mellem kontrolelementets venstre kant og venstre kant af den overordnede objektbeholder (eller skærmbilledet, hvis der ingen overordnet objektbeholder er).
Y – Afstanden mellem kontrolelementets øverste kant og den øverste kant af overordnet objektbeholder (eller skærmbilledet, hvis der ingen overordnet objektbeholder er).
Bemærk
Kantegenskaber for pop op-vindue kan styres af Kant-egenskaber.
Eksempler
Grundlæggende kombinationsfelt
Trinnene i dette eksempel gælder for enhver datakilde, der indeholder tabeller, men hvis du vil følge præcist disse trin, skal du bruge et miljø, hvor Microsoft Dataverse-databasen har eksempeldata.
Vælg Indsæt > Input > Kombinationsfelt, og navngiv det "Kombinationsfelt1".
Åbn listen Vælg en datakilde (ved Items) i ruden Items i højre side af skærmen, og tilføj eller vælg derefter en datakilde som f.eks. tabellen Konti.
Vælg Rediger (ud for Felter) i samme rude.
Åbn listen Primær tekst i ruden Data, og vælg derefter kolonnen Primært navn, der skal vises i kontrolelementet Kombinationsfelt.
Mens du holder Alt-tasten nede, skal du vælge Pil ned for at åbne kontrolelementet Kombinationsfelt.
Kontrolelementet viser dataene fra det primære navn, du har angivet i den angivne datakilde.
(Valgfrit) Vis den første post som standard
Angiv egenskaben DefaultSelectedItems til dette udtryk, så DataSource erstattes af navnet på datakilden:
First(DataSource)
(Valgfrit) Vis den valgte værdi for Kontonavn i en etiket
Vælg Indsæt > Tekstetiket, og vælg derefter Etiket.
Angiv egenskaben Text til dette udtryk, så Text erstattes af følgende formel:
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")Bemærk
If-sætningen kontrollerer, hvordan udvalgte elementer forekommer, og de vises i en kommasepareret etiket eller i meddelelsen "NO SELECTED ITEM", når de er tomme.
Simulere simpel funktionsmåde for rullelisten
Hvis du indstiller IsSearchable til false og SelectMultiple til false, kan du opnå samme funktionalitet for en rulleliste.
Vælg Indsæt > Input, og vælg derefter Kombinationsfelt.
Åbn listen Vælg en datakilde (ved Items) i ruden Items i højre side af skærmen, og tilføj eller vælg derefter en datakilde.
Vælg Rediger (ud for Felter) i samme rude.
Åbn listen Primær tekst i ruden Data, og vælg derefter den kolonne, der skal vises i kontrolelementet Kombinationsfelt.
Angiv egenskaben IsSearchable til false.
Angiv egenskaben SelectMultiple til false.
Mens du holder Alt-tasten nede, skal du vælge Pil ned for at åbne kontrolelementet Kombinationsfelt.
Kontrolelementet viser dataene fra den kolonne, som du har angivet i den datakilde, du har angivet.
Bemærk
Teksten "Søg efter elementer" kan kun bruges på én gang, og du kan kun vælge et enkelt element.
Retningslinjer for tilgængelighed
Farvekontrast
Der skal være tilstrækkelig farvekontrast mellem:
- ChevronFill og ChevronBackground
- ChevronHoverFill og ChevronHoverBackground
- SelectionColor og SelectionFill
- SelectionFill og Fill
- SelectionTagColor og SelectionTagFill
Dette er et tillæg til kravene til kontraster for standardfarver.
Understøttelse af skærmlæser
AccessibleLabel skal være til stede.
Bemærk
På berøringsskærme kan brugere af skærmlæsere navigere til indholdet i kombinationsfeltet i rækkefølge. Kombinationsfeltet fungerer som en knap, der viser eller skjuler indholdet, når det markeres.
Understøttelse af tastatur
TabIndex skal være nul eller højere, så tastaturbrugere kan navigere til den.
Fokusindikatorer skal være tydelige. Brug FocusedBorderColor og FocusedBorderThickness for at opnå dette.
Bemærk
Tabulatortasten navigerer til eller væk fra et kombinationsfelt. Piletaster navigerer rundt i indholdet i kombinationsfeltet. Escape-tasten lukker rullelisten, når den er åben.
Bemærk
Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)
Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).