Contrôle galerie dans Power Apps

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

Descriptif

Un contrôle Gallery 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 montrant les 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 Gallery . Vous pouvez également configurer ces contrôles dans son modèle. Le modèle apparaît en tant que premier élément à l’intérieur de la galerie :

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

Toutes 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 et une galerie pour les éléments de hauteur variable.

Limites

Le contrôle galerie présente les limitations suivantes :

1. Si un utilisateur fait défiler le contrôle de galerie de hauteur flexible avant que tous les éléments soient chargés, l’élément actuellement affiché peut être poussé vers le bas et hors d’affichage lorsque le chargement des données est terminé. Pour éviter ce problème, utilisez un contrôle Galerie standard au lieu de la variante de hauteur flexible .
2. Les contrôles suivants ne sont pas pris en charge dans une galerie :
   • Formulaire d’affichage
   • Modifier le formulaire
   • Visionneuse PDF
   • Vignette Power BI
   • Éditeur de texte enrichi
   • Écran à défilement (grille Fluid)
   • Scanneur de codes-barres web
3. Vous ne pouvez pas ajouter une galerie à l’intérieur d’une autre galerie si celle-ci est déjà à l’intérieur d’une autre galerie. Le niveau maximal d’imbrication est de 2.
4. Le modèle Minimal TemplateSize est un. Cela peut entraîner la dérive des contrôles dans la galerie à partir de leurs valeurs X ou Y attendues, lorsque vous ne comptez pas pour la taille du modèle.
5. Si vous générez automatiquement une application à partir de données, enregistrez l’application, puis rouvrez-la, la galerie de navigation risque de 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 affiche ensuite les données comme prévu.
6. Si une galerie inclut un contrôle ComboBox, DatePicker, Slider ou Bascule avec une OnChange règle qui corrige la même source de données ou collection que la galerie, cela peut entraîner des performances inattendues ou réduites. Cela est dû au fait qu’une OnChange règle qui corrige la source de données de la galerie peut créer un cycle sans fin de mise à jour corrective et de rechargement. Pour éviter ce problème, il est conseillé de ne pas utiliser OnChange de règles lorsque ces contrôles sont placés dans une galerie.

Propriétés principales

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

Éléments : source de données qui apparaît dans un contrôle tel qu’une galerie, une liste ou un graphique.

Sélectionné : élément sélectionné.

Propriétés supplémentaires

AccessibleLabel : étiquette de la galerie (et non les éléments qu’elle contient) pour les lecteurs d’écran. Doit décrire la liste des éléments.

AllItems : éléments chargés dans la galerie. Cela peut être inférieur au nombre réel d’éléments de la source de données. D’autres éléments peuvent être chargés lorsque la galerie fait défiler la galerie. AllItems contient également des contrôles utilisés 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 de la source de données. D’autres éléments peuvent être chargés lorsque la galerie fait défiler la galerie.

BorderColor : couleur de la bordure d’un contrôle.

BorderStyle : indique si la bordure d’un contrôle est Solid, Dashed, Dotted ou None.

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

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

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

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

Hauteur : distance entre les bords supérieurs et inférieurs d’un contrôle.

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

LoadingSpinner (None, Controls ou Data) - Quand Aucun, le spinner ne s’affiche pas. Quand les contrôles | Les données, le spinner s’affiche lorsqu’une passe de rendu se produit, ce qui entraîne des lignes vides visibles.

LoadingSpinnerColor : couleur de remplissage du spinner de chargement. La valeur par défaut est BorderColor.

NavigationStep : jusqu’à quel point une galerie défile si sa propriété ShowNavigation a la valeur true et que l’utilisateur sélectionne une flèche de navigation à l’une ou l’autre des extrémités de cette galerie.

Sélectionnable : indique si les éléments de la galerie peuvent être sélectionnés. Lorsque la valeur est true, les lecteurs d’écran identifient la galerie comme une liste sélectionnable. Vous sélectionnez un élément en le sélectionnant. Lorsque la valeur est false, les lecteurs d’écran identifient la galerie en tant que 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 parcourir les éléments de 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 les éléments d’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 une.

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

Visible : indique si un contrôle apparaît ou est masqué.

Largeur : distance entre les bords gauche et droit 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 conteneur parent ou de son écran.

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

Fonctions associées

Filter( DataSource, Formula )

Reset( Control ) : réinitialise votre galerie à son état initial. L’état initial inclut le défilement vers le premier élément et la sélection du premier élément ou de la valeur par défaut s’il est présent.

Examples

Afficher et filtrer les données

• Afficher le texte
• Afficher des images
• Filtrer les données en sélectionnant une option de liste
• Filtrer les 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

Conseils sur l’accessibilité

Contraste des couleurs

Si vous cliquez n’importe où dans un élément de galerie est destiné à le sélectionner, il doit y avoir un contraste de couleur adéquat entre :

• BorderColor et couleur en dehors de la galerie (s’il existe une bordure).
• Remplissez et 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.

  Note

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

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

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

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

• La sélection doit être définie de manière appropriée, selon que les utilisateurs sont destinés à sélectionner un élément de galerie.

Prise en charge du clavier

• Envisagez de définir ShowScrollbar sur true. Sur la plupart des appareils tactiles, la barre de défilement ne s’affiche pas tant que le défilement ne commence pas.

• Si vous cliquez n’importe où dans un élément de galerie est destiné à le sélectionner, il doit également être possible pour les utilisateurs du clavier de 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).

  Note

  Les contrôles en dehors de la galerie ne sont pas pris en compte dans l’ordre de navigation du clavier dans la galerie. Les contrôles TabIndex à l’intérieur d’une galerie sont délimités. Pour en savoir plus, consultez les propriétés d’accessibilité .

Voir aussi

Utiliser DelayItemLoading et le chargement du spinner pour améliorer les performances dans la galerie