Contrôle Galerie dans Power Apps

Un contrôle qui contient d’autres contrôles et affiche un jeu de données.

Description

Une commande Galerie peut afficher plusieurs enregistrements à partir d’une source de données, et chaque enregistrement peut contenir plusieurs types de données. Par exemple, utilisez un contrôle Galerie pour afficher plusieurs contacts avec chaque élément affichant des informations de contact qui incluent un nom, une adresse et un numéro de téléphone pour chaque contact.

Chaque champ de données apparaît dans un contrôle distinct dans le contrôle Galerie. Et vous pouvez configurer ces contrôles dans son modèle. Le modèle apparaît comme le premier élément de la galerie :

• Sur le bord gauche d’un contrôle Galerie en orientation horizontale/paysage.
• Et au sommet d’un contrôle Galerie en orientation verticale/portrait.

Les modifications que vous apportez dans le modèle sont reflétées dans le contrôle Galerie.

Les modèles prédéfinis pour afficher des images et du texte dans une galerie sont disponibles ainsi qu’une galerie pour les éléments de hauteur variable.

Limitations

Le contrôle Galerie a les limitations suivantes :

1. Si un utilisateur fait défiler le contrôle Galerie Flexible height avant que tous les éléments soient chargés, l’élément qui est actuellement en vue peut être poussé vers le bas et hors de la vue lorsque le chargement des données est terminé. Pour éviter ce problème, utilisez un contrôle standard Galerie au lieu de la variante Flexible height.
2. Les contrôles suivants ne sont pas compatibles avec une galerie :
   • Afficher le formulaire
   • Modifier le formulaire
   • Visionneuse PDF
   • Vignette Power BI
   • Éditeur de texte enrichi
   • Scrollable screen (Fluid grid)
   • Scanneur de codes-barres web
3. Vous ne pouvez ajouter qu’une seule galerie à l’intérieur d’une autre galerie.
4. La TemplateSize minimum est 1. Cela peut faire dériver les contrôles de la Galerie de leur valeur X ou Y prévue, lorsque vous ne tenez pas compte de la taille du modèle.
5. Si vous générez une application automatiquement à partir de données, si vous enregistrez l’application, puis si vous la rouvrez, la galerie à parcourir peut ne pas afficher immédiatement les données. Pour résoudre ce problème, tapez au moins un caractère dans la zone de recherche, puis supprimez le texte que vous avez tapé. La galerie affichera ensuite les données comme prévu.
6. Si une galerie inclut un contrôle ComboBox, DatePicker, Slider ou Toggle avec une règle qui corrige le même source de données ou la même collection que la galerie, cela peut entraîner des performances inattendues ou réduites. OnChange C’est parce qu’une règle qui corrige le source de données de la galerie peut créer un cycle sans fin de corrections et de rechargement. OnChange Pour éviter ce problème, il est conseillé de ne pas utiliser de règles lorsque ces contrôles sont placés dans une galerie. OnChange

Propriétés principales

Default : élément ou enregistrement de la source de données à sélectionner dans la galerie au démarrage de l’application.

Items : source de données qui apparaît dans un contrôle comme une galerie, une liste ou un graphique.

Selected : l’élément sélectionné.

Propriétés supplémentaires

AccessibleLabel : Étiquette de la galerie (pas les éléments qu’elle contient) pour les lecteurs d’écran. Doit décrire de quelle liste d’éléments il s’agit.

AllItems – Éléments chargés dans la galerie. Cela peut être inférieur au nombre réel d’éléments du source de données. Plus d’éléments peuvent être chargés quand la galerie défile. AllItems contient également des contrôles utilisées dans chaque élément de la galerie.

AllItemsCount : nombre d’éléments chargés dans la galerie. Cela peut être inférieur au nombre réel d’éléments du source de données. Plus d’éléments peuvent être chargés quand la galerie défile.

BorderColor : couleur de bordure du contrôle.

BorderStyle : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.

BorderThickness : épaisseur de bordure d’un contrôle.

DelayItemLoading : Retarder le chargement des éléments (lignes) jusqu’à ce que l’écran soit chargé pour la première fois.

DisplayMode : indique si le contrôle autorise l’entrée utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).

Fill : couleur d’arrière-plan d’un contrôle.

Height : distance entre le haut et le bas d’un contrôle.

ItemAccessibleLabel : Étiquette de chaque élément de la galerie pour les lecteurs d’écran. Devrait décrire ce que chaque élément est.

LoadingSpinner (None, Controls or Data) : si définie sur None, la toupie ne s’affiche pas. Quand Contrôles | Données, la toupie s’affiche lorsqu’une passe d’affichage se produit qui entraîne des lignes vides visibles.

LoadingSpinnerColor : couleur de remplissage de la toupie de chargement. Par défaut, la valeur est définie sur BorderColor.

NavigationStep : jusqu’où une galerie défile si sa propriété ShowNavigation est définie sur true et si l’utilisateur sélectionne une flèche de navigation aux deux extrémités de cette galerie.

Selectable : Si les éléments de la galerie peuvent être sélectionnés. Lorsqu’ils sont réglés sur true, les lecteurs d’écran identifient la galerie comme une liste sélectionnable. Et vous sélectionnez un élément en le sélectionnant. Lorsqu’ils sont réglés sur false, les lecteurs d’écran identifient la galerie comme une liste régulière et la sélection d’un élément ne le sélectionne pas.

ShowNavigation : indique si une flèche apparaît à chaque extrémité d’une galerie afin qu’un utilisateur puisse faire défiler les éléments dans la galerie en sélectionnant une flèche.

ShowScrollbar : indique si une barre de défilement s’affiche lorsque l’utilisateur pointe sur une galerie.

TemplateFill : couleur d’arrière-plan d’une galerie.

TemplatePadding : distance entre des éléments dans une galerie.

TemplateSize : hauteur du modèle pour une galerie en orientation verticale/portrait. Ou la largeur du modèle pour une galerie en orientation horizontale/paysage. La taille minimale est 1.

Transition : effet visuel (Pop, Push, ou None) lorsque l’utilisateur pointe sur un élément dans une galerie.

Visible : indique si un contrôle est visible ou est masqué.

Width : distance entre les côtés droit et gauche d’un contrôle.

WrapCount : nombre d’éléments affichés par ligne ou colonne en fonction de la disposition horizontale ou verticale.

X : Distance entre le bord gauche d’un contrôle et le bord gauche de son écran ou conteneur parent.

Y : distance entre le bord supérieur d’un contrôle et le bord supérieur de son écran ou conteneur parent.

Fonctions connexes

Filter( DataSource, Formula )

Reset( Control ) : redéfinit votre galerie à son état initial. L’état initial comprend le défilement jusqu’au premier élément et la sélection du premier élément ou par défaut s’il est présent.

Exemples

Afficher et filtrer des données

• Afficher le texte
• Afficher les images
• Filtrer des données en sélectionnant une option de liste
• Filtrer des données en ajustant un curseur

Obtenir des données de l’utilisateur

• Obtenir du texte
• Obtenir des images
• Obtenir des photos
• Obtenir des sons
• Obtenir des dessins

Instructions d’accessibilité

Contraste des couleurs

Si cliquer n’importe où dans un élément de galerie revient à le sélectionner, il doit y avoir un contraste des couleurs adéquat entre :

• BorderColor et la couleur en dehors de la galerie (s’il y a une bordure).
• Fill et la couleur en dehors de la galerie (s’il n’y a pas de bordure).

Prise en charge du lecteur d’écran

• AccessibleLabel doit être présent.

  Notes

  Les lecteurs d’écran annoncent la modification des éléments de la galerie. Le AccessibleLabel est également mentionné. Cela donne le contexte de l’annonce et est encore plus important lorsqu’il existe plusieurs galeries sur le même écran.

• Lorsqu’un élément de la galerie contient plusieurs contrôles, utilisez ItemAccessibleLabelpour afficher le contenu des éléments de la galerie.

• Définissez la valeur de Selectable sur true si vous souhaitez que les utilisateurs sélectionnent un élément de la galerie. Sinon, définissez cette valeur sur false.

• Lorsqu’un élément de la galerie contient plusieurs contrôles, utilisez ItemAccessibleLabel pour fournir un résumé du contenu de l’élément de la galerie.

• Selectable doit être défini de manière appropriée, selon que les utilisateurs sont censés sélectionner un élément de la galerie.

Prise en charge du clavier

• Envisagez de définir ShowScrollbar sur true. Sur la plupart des appareils d’écran tactile, la barre de défilement ne s’affichera pas avant le commencement du défilement.

• Si cliquer n’importe où dans un élément de galerie revient à le sélectionner, les utilisateurs du clavier doivent également pouvoir sélectionner l’élément de galerie. Par exemple, l’ajout d’un Bouton dont la propriété OnSelect est définie sur Select(Parent).

  Notes

  Les contrôles à l’extérieur de la galerie ne sont pas considérés dans l’ordre de navigation du clavier dans la galerie. Les contrôles TabIndex à l’intérieur d’une galerie sont étendus. Consultez propriétés d’accessibilité pour en savoir plus.

Voir aussi

Utiliser DelayItemLoading et la boucle de chargement pour améliorer les performances dans la galerie