Besturingselement Keuzelijst met invoervak in Power Apps
Een besturingselement waarmee gebruikers selecties kunnen maken in geboden opties. Ondersteunt zoeken en meervoudige selectie.
Beschrijving
Met een besturingselement voor Keuzelijst met invoervak kunt u zoeken naar items die u gaat selecteren. De zoekopdracht wordt aan de serverzijde uitgevoerd op de eigenschap SearchField, zodat de prestaties niet worden beïnvloed door grote gegevensbronnen.
De modus voor enkelvoudige of meervoudige selectie wordt geconfigureerd via de eigenschap SelectMultiple.
Wanneer u zoekt naar items om te selecteren, kunt u bij elk item ervoor kiezen één gegevenswaarde, twee waarden of een afbeelding en twee waarden (Persoon) weer te geven door de instelling Indeling in het deelvenster Gegevens te wijzigen.
Bij weergave op kleine schermen wordt de flyout met de lijst met items een besturingselement op een volledig scherm voor een betere bruikbaarheid.
Notitie
Als u items wilt zoeken met getallen, zet getallen om in tekst met de functie Tekst(). Bijvoorbeeld Text(12345).
Beperkingen
Het besturingselement keuzelijst met invoervak heeft de volgende beperkingen:
- Wanneer u het besturingselement voor een keuzelijst met invoervak in een galerie gebruikt, worden de selecties niet behouden als de gebruiker door de galerie scrolt. Dit is geen probleem als u een besturingselement voor een keuzelijst met invoervak gebruikt in een galerie waarin u niet kunt scrollen. Er is momenteel geen oplossing beschikbaar.
Personen selecteren
Als u personen wilt selecteren met behulp van een Keuzelijst met invoervak, kiest u de sjabloon Persoon bij de opmaakinstellingen in het deelvenster Gegevens en configureert u de desbetreffende gegevenseigenschappen die voor de onderstaande persoon moeten worden weergegeven.
Belangrijkste eigenschappen
Items: De gegevensbron waarin selecties kunnen worden gemaakt.
DefaultSelectedItems: Het/de aanvankelijk geselecteerde item(s) voordat de gebruiker het besturingselement gebruikt.
Notitie
De eigenschap Default afgeschaft. Gebruik DefaultSelectedItems.
SelectedItems: Een lijst met geselecteerde items als gevolg van gebruikersinteractie.
SelectMultiple: Bepaalt of de gebruiker één item of meerdere items kan selecteren.
IsSearchable: Bepaalt of de gebruiker naar items kan zoeken alvorens ze te selecteren.
Notitie
IsSearchable kan alleen worden ingeschakeld voor een gegevensbron die ten minste één tekstveld bevat. De expressie Items moet delegeerbaar zijn voor query's om te worden gedelegeerd bij het zoeken. If-instructies in de expressie Items worden dus niet ondersteund.
SearchFields: De gegevensvelden van de betreffende gegevensbron wanneer de gebruiker tekst invoert.
Notitie
Om in meerdere velden te zoeken, stelt u de eigenschap SearchFields in deze indeling in: ["MyFirstColumn", "MySecondColumn"]. Alleen tekstvelden worden ondersteund.
Aanvullende eigenschappen
AccessibleLabel: label voor schermlezers.
BorderColor: de kleur van de rand van een besturingselement.
BorderStyle: hiermee wordt aangegeven of de rand van een besturingselement effen, onderbroken of gestippeld is, of dat er geen rand is.
BorderThickness: de dikte van de rand van een besturingselement.
DisplayFields: Een lijst met velden die worden weergegeven voor elk item dat de zoekopdracht retourneert. Dit is het gemakkelijkst te configureren via het deelvenster Gegevens op het tabblad Eigenschappen.
Notitie
Om meerdere weergavevelden in een sjabloon bij te werken, stelt u de eigenschap DisplayFields in deze indeling in: ["MyFirstColumn", "MySecondColumn"].
DisplayMode: bepaalt of invoer van de gebruiker is toegestaan (Edit), of gegevens alleen worden weergegeven (View) of het besturingselement wordt uitgeschakeld (Disabled).
FocusedBorderColor: de kleur van de rand van een besturingselement wanneer de focus op het besturingselement ligt.
FocusedBorderThickness: de dikte van de rand van een besturingselement wanneer de focus op het besturingselement ligt.
Height: de afstand tussen de boven- en onderrand van een besturingselement.
InputTextPlaceholder: Instructietekst die aan eindgebruikers wordt getoond wanneer er geen items zijn geselecteerd.
OnChange: Acties die moeten worden uitgevoerd wanneer de gebruiker een selectie wijzigt.
OnNavigate: Acties die moeten worden uitgevoerd wanneer de gebruiker een item selecteert.
OnSelect: Acties die moeten worden uitgevoerd wanneer de gebruiker op een besturingselement tikt of er een selecteert.
TabIndex: de navigatievolgorde op het toetsenbord ten opzichte van andere besturingselementen.
Visible: hiermee wordt aangegeven of een besturingselement zichtbaar of verborgen is.
Width: de afstand tussen de linker- en rechterrand van een besturingselement.
X: de afstand tussen de linkerrand van een besturingselement en de linkerrand van de bovenliggende container (het scherm als er geen bovenliggende container is).
Y: de afstand tussen de bovenrand van een besturingselement en de bovenrand van de bovenliggende container (het scherm als er geen bovenliggende container is).
Notitie
Flyout-randeigenschappen worden beheerd door Border-eigenschappen.
Voorbeelden
Eenvoudige keuzelijst met invoervak
De stappen in dit voorbeeld gelden voor elke gegevensbron die tabellen levert, maar om deze stappen exact te volgen, gebruikt u een omgeving waarin een Microsoft Dataverse-database voorbeeldgegevens bevat.
Selecteer Invoegen > Invoer > Keuzelijst met invoervak en geef deze de naam "Keuzelijstmetinvoervak1".
Op het deelvenster Eigenschappen aan de rechterkant van het scherm opent u de lijst Een gegevensbron selecteren (naast Items); daarna selecteert u een gegevensbron als de tabel Accounts of voegt u deze toe.
Selecteer in hetzelfde deelvenster Bewerken (naast Velden).
Open in het deelvenster Gegevens de lijst Primaire tekst en selecteer de kolom Primaire naam die wordt weergegeven in het besturingselement Keuzelijst met invoervak.
Terwijl u de Alt-toets ingedrukt houdt, selecteert u de pijl-omlaag om het besturingselement Keuzelijst met invoervak te openen.
Het besturingselement toont de gegevens van de Primaire naam die u hebt opgegeven in de gegevensbron die u hebt opgegeven.
(Optioneel) Het eerste record standaard weergeven
Stel de eigenschap DefaultSelectedItems in op deze expressie, waarmee u Gegevensbron vervangt door de naam van uw gegevensbron:
First(DataSource)
(Optioneel) Geselecteerde accountnaam weergeven in een label
Selecteer Invoegen > Tekstlabel en vervolgens Label.
Stel de eigenschap Text in op deze expressie, waarmee u Text vervangt door de volgende formule:
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")Notitie
De If-instructie controleert hoeveel geselecteerde items er zijn en geeft ze weer in een door komma's gescheiden label of in een bericht "GEEN ITEM GESELECTEERD" als deze leeg is.
Eenvoudig vervolgkeuzegedrag simuleren
Door IsSearchable op onwaar te zetten en SelectMultiple op onwaar, kunt u dezelfde functionaliteit van een vervolgkeuze bereiken.
Selecteer Invoegen > Invoer en vervolgens Keuzelijst met invoervak.
Op het deelvenster Eigenschappen aan de rechterkant van het scherm opent u de lijst Een gegevensbron selecteren (naast Items); daarna selecteert u een gegevensbron of voegt u deze toe.
Selecteer in hetzelfde deelvenster Bewerken (naast Velden).
Open in het deelvenster Gegevens de lijst Primaire tekst en selecteer de kolom die u wilt tonen in het besturingselement Keuzelijst met invoervak.
Stel de eigenschap IsSearchable in op onwaar.
Stel de eigenschap SelectMultiple in op onwaar.
Terwijl u de Alt-toets ingedrukt houdt, selecteert u de pijl-omlaag om het besturingselement Keuzelijst met invoervak te openen.
Het besturingselement toont de gegevens uit de kolom die u hebt opgegeven in de gegevensbron die u hebt opgegeven.
Notitie
De tekst "Items zoeken" is verdwenen en u kunt alleen één item selecteren.
Richtlijnen voor toegankelijkheid
Kleurcontrast
Er moet voldoende kleurcontrast zijn tussen:
- ChevronFill en ChevronBackground
- ChevronHoverFill en ChevronHoverBackground
- SelectionColor en SelectionFill
- SelectionFill en Fill
- SelectionTagColor en SelectionTagFill
Dit komt bovenop de standaardvereisten voor kleurcontrast.
Ondersteuning voor schermlezer
AccessibleLabel moet aanwezig zijn.
Notitie
Op aanraakschermen kunnen gebruikers van de schermlezer achtereenvolgens door de inhoud van de keuzelijst met invoervak navigeren. De keuzelijst met invoervak werkt als een knop die, indien geselecteerd, de inhoud weergeeft of verbergt.
Ondersteuning voor toetsenbord
TabIndex moet nul of groter zijn, zodat toetsenbordgebruikers ernaartoe kunnen navigeren.
De focusindicatoren moeten duidelijk zichtbaar zijn. Gebruik hiervoor FocusedBorderColor en FocusedBorderThickness.
Notitie
Met de Tab-toets navigeert u naar of van de keuzelijst met invoervak. Met de pijltoetsen navigeert u door de inhoud van de keuzelijst met invoervak. Met de Escape-toets sluit u de vervolgkeuzelijst wanneer deze is geopend.
Notitie
Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)
De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).