Galleri-kontrollen i Power Apps

En kontroll som innehåller andra kontroller och visar en datauppsättning.

Beskrivning

En Galleri-kontroll kan visa flera poster från en datakälla, och varje post kan innehålla flera typer av data. Till exempel en Galleri-kontroll kan visa flera kontakter med varje objekt som visar kontaktinformation som innehåller ett namn, en adress och ett telefonnummer för varje kontakt.

Varje data fält visas i en separat kontroll i Galleri-kontrollen. Och du kan konfigurera kontrollerna i mallarna. Mallen visas som det första objektet i galleriet:

• Till vänster i en Galleri-kontroll i stående/liggande orientering.
• Och högst upp i en Galleri-kontroll i stående och liggande orientering.

Alla ändringar du gör i mallen visas i hela galleri-kontrollen.

Fördefinierade mallar för visning av bilder och text i ett galleri och galleri för varierande höjd objekt.

Begränsningar

Den gallerikontrollen har följande begränsningar:

1. Om en användare bläddrar igenom gallerikontrollen flexibel höjd innan alla objekt har lästs in kan objektet som visas i vyn vara nedtryckt och inaktivt när datainläsningen är slutförd. Du kan undvika det här problemet genom att använda en standardkontroll för Galleri i stället för varianten flexibel höjd.
2. Följande kontroller stöds inte i ett galleri:
   • Visa formulär
   • Redigerat formulär
   • PDF-läsare
   • Power BI panel
   • RTF-redigerare
   • Rullningsbar skärm (flytande rutnät)
   • Webbstreckkodsskanner
3. Du kan endast lägga till ett galleri i ett annat galleri.
4. Den minsta TemplateSize är ett. Detta kan göra att kontrollerna i Galleri skiljer sig från deras förväntade värden för X eller Y när du inte anger mallstorleken.
5. Om du automatiskt genererar en app från data, sparar appen och sedan öppnar den igen visar visningsgalleriet kanske inte några data. Ange minst ett tecken i sökrutan för att lösa problemet och ta sedan bort den text som du har angett. Galleriet kommer sedan att visa data som förväntat.
6. Om ett galleri innehåller en ComboBox-, DatePicker-, Slider- eller Toggle-kontroll med en OnChange regel som korrigerar samma datakälla eller samling som galleriet kan det leda till oväntade eller försämrade prestanda. Det beror på att en OnChange regel som korrigerar datakällan i galleriet kan skapa en oändlig cykel av korrigeringar och omladdningar. För att undvika det här problemet rekommenderar vi att du inte använder OnChange regler när dessa kontroller placeras i ett galleri.

Nyckelegenskaper

Default – Den artikel eller post i datakällan som ska väljas i galleriet när appen startas.

Items – Datakällan som visas i en kontroll, t.ex ett galleri, en lista eller ett diagram.

Selected – Det markerade objektet.

Ytterligare egenskaper

AccessibleLabel – etikett för galleriet (inte objekten som det innehåller) för skärmläsare. Bör beskriva vad listan med objekt är.

AllItems – Objekt som läses in i galleriet. Det kan vara mindre än det faktiska antalet objekt i datakälla. Fler objekt kan läsas in när galleriet bläddras. AllItems innehåller även kontroller som används i varje galleriartikel.

AllItemsCount - Antal objekt som har laddats i galleriet. Det kan vara mindre än det faktiska antalet objekt i datakälla. Fler objekt kan läsas in när galleriet bläddras.

BorderColor – En kontrolls kantlinjefärg.

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

BorderThickness – Tjockleken på en kontrolls kantlinje.

DelayItemLoading – fördröj inläsning av objekt (rader) tills skärmen först har lästs in.

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

Fylla – Bakgrundsfärgen i en kontroll.

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

ItemAccessibleLabel – etikett för varje galleriobjekt för skärmläsare. Bör beskriva vad varje objekt är.

LoadingSpinner (Ingen, Kontroller eller Data) – när ingen visas inte rotationsrutan. När kontroller | data visas rotationsrutan när en återgivning uppstår och resultatet visas som tomma rader.

LoadingSpinnerColor – Fyllningsfärgen på rotationsrutan. Som standard är inställningen BorderColor.

NavigationStep – hur långt ett galleri rullar om egenskapen ShowNavigation är inställd på sant och användaren väljer en navigationspil i början eller slutet av galleriet.

Selectable – om galleriobjekt kan väljas. När den anges till sant identifierar skärmläsaren galleriet som en valbar lista. Du väljer ett objekt genom att markera det. Om den är inställd på falsk identifierar skärmläsaren galleriet som en vanlig lista och om du markerar ett objekt markeras det inte.

ShowNavigation – om en pil visas i slutet av ett galleri så att en användare kan bläddra igenom objekten i galleriet genom att välja en pil.

ShowScrollbar – en rullningslist visas när användaren håller muspekaren över ett galleri.

TemplateFill – Bakgrundsfärgen i ett galleri.

TemplatePadding – avståndet mellan objekten i ett galleri.

TemplateSize – höjden på mallen för ett galleri i liggande och stående orientering. Bredden på mallen för ett galleri med stående/liggande orientering. Minimistorleken är ett.

Transition – den visuella effekt (Pop, Push eller None) när användaren håller muspekaren över ett objekt i ett galleri.

Visible – Om en kontroll visas eller är dold.

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

WrapCount – antal objekt som visas per rad eller kolumn baseras på vågrät eller lodrät layout.

X – Avståndet mellan kontrollens vänsterkant och den överordnade containerns eller skärmens vänsterkant.

Y – Avståndet mellan kontrollens övre kant och den överordnade containerns eller skärmens övre kant.

Relaterade funktioner

Filter( DataSource, Formel )

Återställning( Kontroll ) - återställer galleriet till det ursprungliga tillståndet. I ursprungliga tillståndet ingår att bläddra till det första objektet och välja det första objektet eller standardalternativet om det finns.

Exempel

Visa och filtrera data

• Visa text
• Visa bilder
• Filtrera data genom att välja ett alternativ i listan
• Filtrera data genom att justera skjutreglaget

Hämta data från användaren

• Hämta text
• Hämta bilder
• Hämta fotografier
• Hämta ljud
• Hämta ritningar

Riktlinjer för hjälpmedel

Färgkontrast

Om klickning någonstans i ett galleriobjekt är till för att välja det, måste det finnas tillräckligt färgkontrast mellan:

• BorderColor och färg utanför galleriet (om det finns en kantlinje).
• Fyllning och färg utanför galleriet (om det inte finns en kantlinje).

Stöd för skärmläsare

• AccessibleLabel måste finnas.

  Anteckning

  Skärmläsare kommer meddela när objekt i galleriet ändras. AccessibleLabel anges också. Detta ger kontext till meddelandet och är även viktigare när det finns flera gallerier på samma skärm.

• När en galleriartikel innehåller flera kontroller använder du ItemAccessibleLabel för att visa innehållet i galleriobjektet.

• Ställ in värdet för Valbar till sant om du vill att användarna ska välja ett galleriobjekt. Annars anger du värdet till falskt.

• När en galleriartikel innehåller flera kontroller använder du ItemAccessibleLabel för att visa en sammanfattning av galleriobjektets innehåll.

• Kan väljas bör ställas in korrekt beroende på om användarna ska välja ett galleriobjekt eller inte.

Tangentbordsstöd

• Överväg att ställa in ShowScrollbar till sant. Rullningslisten visas inte på de flesta pekskärmsenheter förrän du börjar rulla.

• Om klickning någonstans i ett galleriobjekt är avsett för att välja det, måste det också finnas ett sätt för tangentbordsanvändare att välja galleriobjektet. Till exempel att lägga till en Knapp som har egenskapen OnSelect inställd på Select(Parent).

  Anteckning

  Kontroller utanför galleriet beaktas inte i ordningen för tangentbordsnavigeringen i galleriet. TabIndex-kontroller i ett galleri är begränsade. Läs mer i egenskaper för hjälpmedel.

Se även

Använda DelayItemLoading and Loading spinner för att förbättra prestandan i Galleriet