Dela via

Kombinationsruta-kontroll i Power Apps

  • Artikel

En kontroll där användarna kan välja bland olika alternativ. Har stöd för sökning och flera markeringar.

Beskrivning

En kontroll för Kombinationsruta kan du söka efter objekt som du väljer. Sökningen utförs på serversidan i egenskapen SearchField, vilket innebär att prestandan inte påverkas av mycket stora datakällor.

Enkelt läge eller flervalsläge konfigureras via egenskapen SelectMultiple.

När du söker efter objekt som kan väljas, kan du för varje objekt välja att visa ett enskilt datavärde, två värden, eller en bild och två värden (Person) genom att ändra inställningarna Layout i fönstret Data.

När du visar på små skärmar blir utfällbar objektlista en fullskärmskontroll för bättre användbarhet.

Anteckning

Om du vill söka efter objekt med tal, konverterar du tal till text med text-funktion. Skriv till exempel Text(12345).

Begränsningar

Kontrollen kombinationsruta har följande begränsningar:

  • När du använder en kontrollen kombinationsruta i ett galleri sparas inte valen när användaren bläddrar i galleriet. Det här är inget problem om du använder kontrollen kombinationsruta i ett galleri som det inte går att bläddra i. Det finns ingen lösning för närvarande.

Personväljaren

För att använda kombinationsrutan som en personväljare, väljer du mallen Person från layoutinställningarna i fönstret Data och konfigurerar de relaterade dataegenskaperna som ska visas för personen nedan.

Nyckelegenskaper

Items – Datakällan som val kan göras från.

DefaultSelectedItems – De första markerade objekten innan användaren interagerar med kontrollen.

Anteckning

Egenskapen Default används inte längre – använd DefaultSelectedItems istället.

SelectedItems – Lista med valda objekt till följd av användarinteraktion.

SelectMultiple – Om användaren kan välja ett eller flera objekt.

IsSearchable – Om användaren kan söka efter objekt innan de väljs.

Anteckning

IsSearchable kan endast aktiveras på en datakälla som innehåller minst ett textfält. Uttrycket Objekt måste vara delegerbart för att frågor ska delegeras med sökning. Det vill säga If-instruktioner u uttrycket Objekt stöds inte.

SearchFields – Datakällans datafält som söks i när användaren anger text.

Anteckning

Om du vill söka på flera fält anger du egenskapen SearchFields i det här formatet: ["MyFirstColumn", "MySecondColumn"]. Endast textfält stöds.

Ytterligare egenskaper

AccessibleLabel – Etikett för skärmläsare.

BorderColor – En kontrolls kantlinjefärg.

BorderStyle – Om en kontrolls kantlinje är solid, streckad, prickad eller ingen.

BorderThickness – Tjockleken på en kontrolls kantlinje.

DisplayFields – Lista med fält som visas för varje objekt som returneras av sökningen. Detta är enklast att konfigurera via fönstret Data på fliken Egenskaper.

Anteckning

Om du vill uppdatera flera visningsfält i en mall anger du egenskapen DisplayFields i följande format: ["MyFirstColumn", "MySecondColumn"].

DisplayMode – Om kontrollen tillåter indata från användaren (redigera), bara visar data (visa) eller inaktiverad (inaktiverad).

FocusedBorderColor – Färgen på en kontrolls kantlinje när kontrollen har fokus.

FocusedBorderThickness – Tjockleken på en kontrolls kantlinje när kontrollen har fokus.

Height – Avståndet mellan kontrollens övre och nedre kanter.

InputTextPlaceholder – Instruktionstext som visas för slutanvändarna när inga objekt har markerats.

OnChange – Åtgärder som ska utföras när användaren ändrar ett val.

OnNavigate – Åtgärder som ska utföras när användaren väljer ett objekt.

OnSelect – Åtgärder som ska utföras när användaren trycker på eller väljer en kontroll.

TabIndex – Tangentbordets navigeringsordning i förhållande till andra kontroller.

Visible – Om en kontroll visas eller är dold.

Width – Avståndet mellan kontrollens högra och vänstra kanter.

X – Avståndet mellan kontrollens vänstra kant och den överordnade containerns vänstra kant (skärmen om det inte finns någon överordnad behållare).

Y – Avståndet mellan kontrollens övre kant och den överordnade containerns övre kant (skärmen om det inte finns någon överordnad behållare).

Anteckning

Utfällbar meny gränsegenskaper kontrolleras av Border egenskaper.

Exempel

Grundläggande kombinationslåda

Stegen i detta exempel gäller alla datakällor som tillhandahåller tabeller, men för att följa dessa steg exakt, använd en miljö med Microsoft Dataverse databas med exempeldata.

  1. Välj Infoga > Inmatning > Kombinationsruta och namnge den "Combobox1".

  2. I fönstret Egenskaper till höger på skärmen öppnar du listan Välj en datakälla (bredvid objekt) och lägg sedan till eller välj en datakälla, t.ex. kontotabellen.

  3. I samma fönster väljer du Redigera (bredvid fält).

  4. I datafönstret, öppnar den primära textlista och välj sedan huvudnamnet kolumn som kommer att visas i Kombinationsruta kontroll.

  5. Håll ned Alt- tangenten och välj nedåtpilen för att öppna Kombinationsruta.

    Kontrollen visar data från det primära namnet som du angav i den datakälla som du angav.

(Valfritt) Visa den första posten som standard

  1. Ställ in egenskapen DefaultSelectedItems till det här uttrycket och ersätt DataSource med namnet på din datakälla:

    First(DataSource)

(Valfritt) Visa valt kontonamnvärde i en etikett

  1. Välj Infoga > Textetikett och välj sedan Etikett.

  2. Ställ in egenskapen Text till detta uttryck och ersätt text med följande formel:

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")

    Anteckning

    If-uttalandet kommer att kontrollera hur det kan finnas valda objekt och visa dem i en kommaseparerad etikett eller ett "NO SELECTED ITEM" -meddelande när de är tomma.

Simulera enkelt rullgardinsbeteende

Genom att ställa in IsSearchable till false och SelectMultiple till false kan du uppnå samma funktion som en rullgardinsmeny.

  1. Välj Infoga > Ange och välj sedan kombinationsruta.

  2. I fönstret Egenskaper till höger på skärmen öppnar du listan Välj en datakälla (bredvid Objekt) och sedan lägger till eller väljer en datakälla.

  3. I samma fönster väljer du Redigera (bredvid fält).

  4. I fönstret Data öppna listan primär text och markera den kolumn som du vill visa i kontrollen Kombinationsruta.

  5. Ställ in egenskapen IsSearchable på false.

  6. Ställ in egenskapen SelectMultiple på false.

  7. Håll ned Alt- tangenten och välj nedåtpilen för att öppna Kombinationsruta.

    Kontrollen visar data från kolumnen som du angav i den datakälla som du angav.

    Anteckning

    Texten "Hitta objekt" har försvunnit och att du bara kan välja ett objekt.

Riktlinjer för hjälpmedel

Färgkontrast

Det måste finnas tillräcklig färgkontrast mellan:

  • ChevronFill och ChevronBackground
  • ChevronHoverFill och ChevronHoverBackground
  • SelectionColor och SelectionFill
  • SelectionFill och Fyllning
  • SelectionTagColor och SelectionTagFill

Detta är utöver standardkravet på färgkontrast.

Stöd för skärmläsare

  • AccessibleLabel måste finnas.

    Anteckning

    På pekskärmar, kan användare av skärmläsare navigera i innehållet i kombinationsrutan sekventiellt. Kombinationsrutan fungerar som en knapp som visar eller döljer dess innehåll när den valts.

Tangentbordsstöd

  • TabIndex måste vara noll eller större så att tangentbordsanvändare kan navigera till det.

  • Fokusindikatorer måste vara väl synliga. Använd FocusedBorderColor och FocusedBorderThickness för att uppnå detta.

    Anteckning

    Tabbtangenten navigerar till eller bort från kombinationsrutan. Piltangenter navigerar igenom innehållet i kombinationsrutan. ESC-tangenten stänger den nedrullningsbara listan när den öppnas.

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).