Besturingselement Galerij in Power Apps

  • Artikel

Een besturingselement dat andere besturingselementen bevat en waarin een reeks gegevens wordt weergegeven.

Beschrijving

Een besturingselement Galerij kan meerdere records uit een gegevensbron weergeven. Elke record kan meerdere typen gegevens bevatten. U kunt het besturingselement Galerij bijvoorbeeld gebruiken om meerdere contactpersonen weer te geven, waarbij voor elke persoon contactgegevens worden vermeld zoals een naam, een adres en een telefoonnummer.

Elk gegevensveld verschijnt in een apart besturingselement binnen het besturingselement Galerij. Bovendien kunt u deze besturingselementen in de bijbehorende sjabloon configureren. De sjabloon verschijnt als het eerste item in de galerie:

  • Aan de linkerrand van het besturingselement Galerij in horizontale/liggende richting.
  • En boven aan het besturingselement Galerij in verticale/staande richting.

Alle wijzigingen die u in de sjabloon aanbrengt, worden overal in het besturingselement Galerij doorgevoerd.

Er zijn vooraf gedefinieerde sjablonen beschikbaar voor het weergeven van afbeeldingen en tekst in een galerie, en een galerie voor items met variabele hoogte.

Beperkingen

  • Als een gebruiker door het besturingselement Galerij met flexibele hoogte scrolt voordat alle items zijn geladen, wordt het item dat momenteel wordt weergegeven naar beneden verplaatst en verdwijnt het uit het zicht wanneer de gegevens zijn geladen. Gebruik het standaardbesturingselement Galerij in plaats van het de variant met flexibele hoogte om dit probleem te voorkomen.
  • De volgende besturingselementen worden niet ondersteund binnen een galerie:
  • U kunt slechts één galerie binnen een andere galerie toevoegen.
  • De minimale TemplateSize is één. Dit kan ertoe leiden dat bedieningselementen in de galerij afwijken van hun verwachte X- of Y- waarden, wanneer u geen rekening houdt met de sjabloongrootte.

Belangrijke eigenschappen

Default: het item in de gegevensbron dat, of de record in de gegevensbron die, moet worden geselecteerd in de galerie wanneer de app wordt opgestart.

Items: de gegevensbron die wordt weergegeven in een besturingselement zoals een galerie, een lijst of een grafiek.

Selected: het geselecteerde item.

Aanvullende eigenschappen

AccessibleLabel: label van de galerie (niet de items die het bevat) voor schermlezers. Moet beschrijven waaruit de lijst met items bestaat.

AllItems: items die in de galerij worden geladen. Dit kunnen er minder zijn dan het werkelijke aantal items van de gegevensbron. Er kunnen meer items worden geladen wanneer door de galerij wordt geschoven. AllItems bevat ook besturingselementen die in elk galerij-item worden gebruikt.

AllItemsCount: aantal items dat in de galerie is geladen. Dit kunnen er minder zijn dan het werkelijke aantal items van de gegevensbron. Er kunnen meer items worden geladen wanneer door de galerij wordt geschoven.

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.

DelayItemLoading: hiermee wordt het laden van items (rijen) uitgesteld totdat het scherm voor het eerst is geladen.

DisplayMode: bepaalt of invoer van de gebruiker is toegestaan (Edit), of gegevens alleen worden weergegeven (View) of het besturingselement wordt uitgeschakeld (Disabled).

Fill: de achtergrondkleur van een besturingselement.

Height: de afstand tussen de boven- en onderrand van een besturingselement.

ItemAccessibleLabel: label van elk galerie-item voor schermlezers. Moet beschrijven wat elk item inhoudt.

LoadingSpinner (None, Controls of Data): als None is ingesteld, wordt de spinner niet weergegeven. WanneerControls | Datas wordt geselecteerd, wordt een spinner weergegeven wanneer een renderpass optreedt die resulteert in zichtbare lege rijen.

LoadingSpinnerColor: de vulkleur van de laadspinner. De standaardinstelling is BorderColor.

NavigationStep: hoe ver een galerie doorschuift als de eigenschap ShowNavigation is ingesteld op true en de gebruiker een navigatiepijl selecteert aan het begin of het einde van die galerie.

Selectable: bepaalt of galerie-items kunnen worden geselecteerd. Als deze eigenschap is ingesteld op true, beschouwen schermlezers de galerie als een selecteerbare lijst. U selecteert een item dus door het te selecteren. Als deze eigenschap is ingesteld op false, beschouwen schermlezers de galerie als een gewone lijst en wordt een item niet geselecteerd als u het selecteert.

ShowNavigation: bepaalt of er een pijl aan het begin en het einde van een galerie wordt weergegeven, zodat een gebruiker door de items in de galerie kan scrollen door een pijl te selecteren.

ShowScrollbar: bepaalt of er een schuifbalk wordt weergegeven wanneer de gebruiker een galerie aanwijst.

TemplateFill: de achtergrondkleur van een galerie.

TemplatePadding: de afstand tussen items in een galerie.

TemplateSize: de hoogte van de sjabloon voor een galerie in verticale/staande richting. Of de breedte van de sjabloon voor een galerie in horizontale/liggende richting. De minimale grootte is één.

Transition: het visuele effect (Pop, Push of None) dat wordt toegepast wanneer de gebruiker een item in een galerie aanwijst.

Visible: hiermee wordt aangegeven of een besturingselement zichtbaar of verborgen is.

Width: de afstand tussen de linker- en rechterrand van een besturingselement.

WrapCount: het aantal items dat per rij of kolom wordt weergegeven op basis van horizontale of verticale indeling.

X: de afstand tussen de linkerrand van een besturingselement en de linkerrand van de bovenliggende container of het scherm.

Y: de afstand tussen de bovenrand van een besturingselement en de bovenrand van de bovenliggende container of het scherm.

Filter( DataSource, Formula )

Reset( Control ): hiermee wordt de beginstatus van uw galerie hersteld. De beginstatus houdt in dat wordt gescrold naar het eerste item en dat het eerste item of eventuele standaarditem wordt geselecteerd.

Notitie

Met het besturingselement Reset worden niet alle onderliggende items van de galerie hersteld.

Voorbeelden

Gegevens weergeven en filteren

Gegevens ophalen van de gebruiker

Richtlijnen voor toegankelijkheid

Kleurcontrast

Als iets moet worden geselecteerd wanneer ergens in een galerij-item wordt geklikt, moet er voldoende kleurcontrast zijn tussen:

  • BorderColor en de kleur buiten de galerie (als er een rand is).
  • Fill de kleur buiten de galerie (als er geen rand is).

Ondersteuning voor schermlezer

  • AccessibleLabel moet aanwezig zijn.

    Notitie

    Schermlezers melden het als items in de galerie veranderen. Het AccessibleLabel wordt ook vermeld. Dit geeft context aan de aankondiging en is nog belangrijker wanneer er meerdere galerieën op hetzelfde scherm staan.

  • Wanneer een galerie-item meerdere besturingselementen bevat, gebruikt u ItemAccessibleLabel om de inhoud van galerie-items weer te geven.

  • Stel de waarde van Selectable in op true als u wilt dat gebruikers een galerie-item kunnen selecteren. Stel die waarde anders in op false.

  • Wanneer een galerie-item meerdere besturingselementen bevat, gebruikt u ItemAccessibleLabel om een samenvatting van de inhoud van het galerie-item te verschaffen.

  • Geef bij Selectable aan of u wilt dat gebruikers een galerie-item kunnen selecteren of niet.

Ondersteuning voor toetsenbord

  • U kunt ShowScrollbar instellen op true. Op de meeste apparaten met een aanraakscherm wordt de schuifbalk pas weergegeven wanneer er wordt gescrold.

  • Als iets moet worden geselecteerd als ergens in een galerij-item wordt geklikt, moeten toetsenbordgebruikers het galerie-item ook kunnen selecteren. Voeg bijvoorbeeld een Knop toe waarvan de eigenschap OnSelect is ingesteld op Select(Parent).

    Notitie

    Besturingselementen buiten de galerie worden niet meegenomen in de navigatievolgorde voor het toetsenbord binnen de galerie. Besturingselementen TabIndex in een galerie vallen binnen het bereik. Zie eigenschappen voor toegankelijkheid voor meer informatie.

Zie ook

DelayItemLoading en spinner Laden gebruiken om de prestaties in Galerie te verbeteren

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