Kombinasjonsboks-kontrollen i Power Apps
En kontroll som gjør det mulig for brukere å foreta valg ut ifra angitte valgmuligheter. Støtter søk og flervalg.
Beskrivelse
En Kombinasjonsboks gjør det mulig for deg å søke etter elementer du vil velge. Dette søket utføres på serversiden i SearchField-egenskapen, slik at ytelsen ikke påvirkes av store datakilder.
Enkelt- og flervalgsmodus konfigureres via SelectMultiple-egenskapen.
Når du søker etter elementer som du skal velge, kan du for hvert element velge å vise en enkelt dataverdi, to verdier, eller et bilde og to verdier (Person) ved å endre innstillingene for oppsett i Data-ruten.
Når du viser på små skjermer, blir undermenyen for elementlisten en fullskjermkontroll for bedre brukervennlighet.
Obs!
Hvis du vil søke etter elementer med tall, konverterer du tallene til tekst Text()-funksjonen. Skriv for eksempel inn Text(12345).
Begrensninger
Kombinasjonsboks-kontrollen har disse begrensningene:
- Når du bruker en Kombinasjonsboks-kontroll i et galleri, beholdes ikke valgene for den når brukeren ruller i galleriet. Dette er ikke et problem hvis du bruker en Kombinasjonsboks-kontroll i et galleri som ikke ruller. En midlertidig løsning er ikke tilgjengelig.
Personvelger
For å bruke Kombinasjonsboks som personvelger, velger du Person-malen i innstillingene for oppsett i Data-ruten, og konfigurerer de relaterte dataegenskapene slik at de vises for personen under.
Nøkkelegenskaper
Items – datakilden det kan foretas valg ut ifra.
DefaultSelectedItems – de opprinnelig valgte elementene før brukeren tar i bruk kontrollen.
Obs!
Default-egenskapen er avskrevet, bruk Bruk i stedet DefaultSelectedItems.
SelectedItems – listen over valgte elementer som resultat av brukermedvirkning.
SelectMultiple – om brukeren kan velge et enkelt eller flere elementer.
IsSearchable – hvorvidt brukeren kan søke etter elementer før vedkommende foretar et valg.
Obs!
IsSearchable kan bare aktiveres på en datakilde som inneholder minst ett tekstfelt. Items-uttrykket må kunne delegeres for at spørringer skal delegeres med søk. Det vil si at If-setninger i Items-uttrykket ikke støttes.
SearchFields – datafeltene i datakilden søker når brukeren skriver inn tekst.
Obs!
Hvis du vil søke etter flere felter, angir du egenskapen SearchFields i dette formatet: ["MyFirstColumn", "MySecondColumn"]. Bare tekstfelt støttes.
Tilleggsegenskaper
AccessibleLabel – etikett for skjermlesere.
BorderColor – fargen på kontrollens kantlinje.
BorderStyle – hvorvidt kontrollens kantlinje er heltrukket, stiplet, prikket eller ingen.
BorderThickness – tykkelsen på kontrollens kantlinje.
DisplayFields – liste over felt som vises for hvert element som returneres av søket. Enklest å konfigurere via Data-ruten i Alternativer for Egenskaper-fanen.
Obs!
Hvis du vil oppdatere flere visningsfelter i en gitt mal, angir du egenskapen DisplayFields i dette formatet:["MyFirstColumn", "MySecondColumn"].
DisplayMode – hvorvidt kontrollen tillater brukerinndata (Rediger), bare viser data (Vis) eller er deaktivert (Deaktivert).
FocusedBorderColor – fargen på kontrollens kantlinje når kontrollen er fokusert.
FocusedBorderThickness – tykkelsen på kontrollens kantlinje når kontrollen er fokusert.
Height – avstanden mellom kontrollens øvre og nedre kant.
InputTextPlaceholder – veiledningstekst som vises for sluttbrukere når ingen elementer er valgt.
OnChange – Handlinger som skal utføres når brukeren endrer et valg.
OnNavigate – Handlinger som skal utføres når brukeren velger en vare.
OnSelect – Handlinger som skal utføres når brukeren trykker på eller velger en kontroll.
TabIndex – navigasjonsrekkefølge for tastatur i forhold til andre kontroller.
Visible – om kontrollen vises eller skjules.
Width – avstanden mellom kontrollens venstre og høyre kant.
X – avstanden mellom kontrollens venstre kant og den venstre kanten til kontrollens overordnede beholder (eller skjermen, hvis det ikke finnes noen overordnet beholder).
Y – avstanden mellom kontrollens øvre kant og den øvre kanten til kontrollens overordnede beholder (eller skjermen, hvis det ikke finnes noen overordnet beholder).
Obs!
Egenskaper for undermenygrense styres av Border-egenskapene.
Eksempler
Grunnleggende kombinasjonsboks
Trinnene i dette eksemplet gjelder for alle datakilder som inneholder tabeller, men hvis du vil følge disse trinnene nøyaktig, bruker du et miljø der Microsoft Dataverse-databasen har eksempeldata.
Velg Sett inn > Inndata > Kombinasjonsboks for inndata, og gi den navnet Combobox1.
Åpne listen Velg et datakilde (ved siden av Items) på Egenskaper-ruten til høyre på skjermen, og legg deretter til eller velg en datakilde for eksempel Kontoer-tabellen.
Velg Rediger (ved siden av Felter) i samme rute.
Åpne Primær tekst-listen i Data-ruten, og velg deretter Primærnavn-kolonnen som skal vises i Kombinasjonsboks-kontrollen.
Velg pil ned i Kombinasjonsboks-kontrollen mens du holder nede Alt-tasten.
Kontrollen viser dataene fra primærnavnet du angav i datakilde du har angitt.
(Valgfritt) Vis den første posten som standard
Sett egenskapen DefaultSelectedItems til dette uttrykket, og erstatt DataSource med navnet på datakilden:
First(DataSource)
(Valgfritt) Vis valgt kontonavnverdi i en etikett
Velg Sett inn > tekstetikett, og velg deretter Etikett.
Sett egenskapen Text til dette uttrykket, og erstatt Text med følgende formel:
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")Obs!
If-setningen kontrollerer hvordan valgte elementer kan finnes, og viser dem i en kommadelt etikett eller en melding om IKKE VALGT ELEMENT når de er tomme.
Simuler enkel rullegardinvirkemåte
Ved å sette IsSearchable til false og SelectMultiple til false, kan du oppnå den samme funksjonaliteten til en rullegardinliste.
Velg Sett inn > Inndata, og velg deretter Kombinasjonsboks.
Åpne listen Velg et datakilde (ved siden av Items) på Egenskaper-ruten til høyre på skjermen, og legg deretter til eller velg en datakilde.
Velg Rediger (ved siden av Felter) i samme rute.
I Data-ruten åpner du Primærtekst-listen, og velger deretter kolonnen du vil vise i Kombinasjonsboks-kontrollen.
Sett egenskapen IsSearchable til false.
Sett egenskapen SelectMultiple til false.
Velg pil ned i Kombinasjonsboks-kontrollen mens du holder nede Alt-tasten.
Kontrollen viser dataene fra kolonnen som du angav i datakilden du har angitt.
Obs!
Teksten Søk etter elementer er forsvunnet, og at du bare kan velge ett enkelt element.
Retningslinjer for tilgjengelighet
Fargekontrast
Det må være tilstrekkelig fargekontrast mellom:
- ChevronFill og ChevronBackground
- ChevronHoverFill og ChevronHoverBackground
- SelectionColor og SelectionFill
- SelectionFill og Fill
- SelectionTagColor og SelectionTagFill
Dette er i tillegg til kravene for standard fargekontrast.
Skjermleserstøtte
AccessibleLabel må vises.
Obs!
På berøringsskjermer kan skjermleserbrukere navigere innholdet i kombinasjonsboksen sekvensielt. Kombinasjonsboksen fungerer som en knapp som viser eller skjuler innholdet når valgt.
Tastaturstøtte
TabIndex må være null eller større, slik at tastaturbrukere kan navigere til den.
Fokusindikatorer må være godt synlige. Bruk FocusedBorderColor og FocusedBorderThickness for å oppnå dette.
Obs!
TAB-tasten navigerer til eller bort fra kombinasjonsboksen. Piltastene navigerer innholdet i kombinasjonsboksen. ESC-tasten lukker rullegardinlisten når den åpnes.
Obs!
Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)
Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).
Tilbakemeldinger
Kommer snart: Gjennom 2024 faser vi ut GitHub Issues som tilbakemeldingsmekanisme for innhold, og erstatter det med et nytt system for tilbakemeldinger. Hvis du vil ha mer informasjon, kan du se: https://aka.ms/ContentUserFeedback.
Send inn og vis tilbakemelding for