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).

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.

  1. Vælg Indsæt > Input > Kombinationsfelt, og navngiv det "Kombinationsfelt1".

  2. Å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.

  3. Vælg Rediger (ud for Felter) i samme rude.

  4. Åbn listen Primær tekst i ruden Data, og vælg derefter kolonnen Primært navn, der skal vises i kontrolelementet Kombinationsfelt.

  5. 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

  1. 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

  1. Vælg Indsæt > Tekstetiket, og vælg derefter Etiket.

  2. 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.

  1. Vælg Indsæt > Input, og vælg derefter Kombinationsfelt.

  2. Å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.

  3. Vælg Rediger (ud for Felter) i samme rude.

  4. Åbn listen Primær tekst i ruden Data, og vælg derefter den kolonne, der skal vises i kontrolelementet Kombinationsfelt.

  5. Angiv egenskaben IsSearchable til false.

  6. Angiv egenskaben SelectMultiple til false.

  7. 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).