Contrôle Gallery dans Power Apps

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

Description

Une commande 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 Gallery 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 Gallery. 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 Gallery en orientation horizontale/paysage.
  • Et au sommet d’un contrôle Gallery en orientation verticale/portrait.

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

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

  • Si un utilisateur fait défiler le contrôle Gallery 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 Gallery au lieu de la variante Flexible height.
  • Les contrôles suivants ne sont pas compatibles avec une galerie :
  • Vous ne pouvez ajouter qu’une seule galerie à l’intérieur d’une autre galerie.

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 : tous les éléments dans une galerie, y compris les valeurs de contrôle supplémentaires qui font partie du modèle de la galerie.

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. Lorsque la toupie Controls | Data 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.

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.

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.

Notes

Le contrôle Reset ne redéfinit pas récursivement tous les enfants de la galerie.

Exemples

Afficher et filtrer des données

Obtenir des données de l’utilisateur

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 ItemAccessibleLabel pour 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 Button 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

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).