Power Apps
Afficher des données dynamiques avec les galeries Power Apps
La galerie est le contrôle qui affiche vos listes de données dans une application : demandes, contacts, interventions. Comment la créer, la filtrer, la trier et la garder rapide, avec de vraies formules.
Une galerie Power Apps est le contrôle qui affiche une liste de données à l’écran : des demandes, des contacts, des produits, des interventions. Vous dessinez une seule ligne, et Power Apps la répète pour chaque enregistrement de la source. C’est ainsi que presque toutes les applications métier présentent leurs données, avant d’ouvrir le détail d’une fiche.
À quoi sert une galerie dans une application métier
Prenons un responsable d’exploitation qui suit les interventions de son équipe dans un fichier Excel partagé. Sur son téléphone, le fichier est illisible. Avec une galerie, il voit une liste claire : le client, l’heure et le statut, avec les urgences en rouge. Il tape le nom d’un client pour le retrouver, touche une ligne et arrive sur le détail de l’intervention. Le technicien, lui, ne voit que ses interventions du jour.
Ce que cela change : la même donnée est présentée selon le besoin de chacun, sans copie ni export, et elle reste à jour pour tout le monde. La galerie ne stocke rien : elle affiche ce que contient la source, comme SharePoint, Dataverse, SQL Server ou Excel, ou encore une collection gardée en mémoire.
Choisir le type de galerie et la créer
Power Apps propose plusieurs formats, à insérer selon l’usage :
| Format | Présentation | Bon usage |
|---|---|---|
| Verticale | Éléments les uns sous les autres, défilement vers le bas | Listes de contacts, de commandes ou de demandes, surtout sur téléphone |
| Horizontale | Éléments côte à côte, défilement latéral | Sélection de produits ou d’images, en laissant de la place en dessous |
| Hauteur flexible | Chaque élément prend la hauteur de son contenu | Textes de longueur très variable, comme des commentaires |
La hauteur flexible a un défaut documenté par Microsoft : si l’utilisateur fait défiler la liste avant la fin du chargement, l’élément affiché peut être poussé hors de l’écran. Quand les textes ont des longueurs proches, préférez une galerie standard. Pour afficher une grille de vignettes, réglez la propriété WrapCount, qui fixe le nombre d’éléments par ligne.
Pour créer une galerie :
- Dans Power Apps Studio, onglet Insertion, sélectionnez Galerie, puis Verticale.
- Dans le volet Propriétés à droite, ouvrez Source de données et choisissez votre table ou votre liste. Si elle n’apparaît pas, ajoutez d’abord la connexion.
- Dans Disposition, choisissez une présentation : titre seul, titre et sous-titre, image et texte.
- Avec Champs, puis Modifier, indiquez quelle colonne s’affiche à quel endroit.
La source choisie s’inscrit dans la propriété Items de la galerie. C’est cette propriété qui décidera de tout ce qui est affiché, comme vous le verrez plus bas.
Personnaliser l’apparence des éléments
Le premier élément de la galerie est son modèle : tout ce que vous y modifiez se répercute sur les autres lignes. Pour y entrer, sélectionnez la galerie, puis l’icône en forme de crayon en haut à gauche. Vous pouvez alors ajouter, retirer ou déplacer des étiquettes, des images et des boutons.
Chaque contrôle du modèle lit la ligne en cours avec ThisItem. Les formules de cette page sont écrites avec la virgule : dans une interface en français, selon la langue ou les réglages régionaux, le séparateur devient le point-virgule (;), et le point-virgule qui enchaîne deux formules devient un double point-virgule (;;).
ThisItem.Titre
Text(ThisItem.DateDemande, "dd/mm/yyyy")
If(ThisItem.Statut.Value = "Urgent", Color.Red, Color.Black)
La première ligne, dans la propriété Text d’une étiquette, affiche la colonne Titre. La deuxième affiche une date au format français. La troisième, dans la propriété Color, écrit en rouge les éléments urgents. Le .Value est nécessaire pour une colonne de choix SharePoint : sans lui, la formule compare un enregistrement à du texte et passe en erreur.
Pour montrer la ligne sélectionnée, placez cette formule dans la propriété TemplateFill de la galerie :
If(ThisItem.IsSelected, Color.LightBlue, Color.White)
D’autres propriétés règlent la mise en page : TemplateSize donne la hauteur d’une ligne (ou sa largeur dans une galerie horizontale), TemplatePadding l’espace entre deux éléments. Pour une image, placez un contrôle Image dans le modèle et réglez sa propriété Image sur la colonne concernée, par exemple ThisItem.Photo. Sa propriété ImagePosition gère le recadrage.
Pour les lecteurs d’écran, renseignez AccessibleLabel pour décrire la liste, et ItemAccessibleLabel pour résumer chaque élément. Si toucher une ligne doit la sélectionner, ajoutez un bouton dont la propriété OnSelect vaut Select(Parent) : les personnes qui utilisent le clavier pourront faire de même.
Filtrer, rechercher et trier les données
Tout se joue dans la propriété Items. Combinez les fonctions de façon à ce que la source fasse le travail.
Afficher une partie de la liste :
Filter(Demandes, Statut.Value = "En attente")
Seules les demandes en attente s’affichent. Plusieurs critères peuvent s’enchaîner, avec && pour « et », || pour « ou ».
Ajouter une barre de recherche : insérez un contrôle Entrée de texte au-dessus de la galerie, et nommez-le RechercheTexte. Deux formules sont alors possibles :
Filter(Demandes, StartsWith(Titre, RechercheTexte.Text))
Search(Demandes, RechercheTexte.Text, Titre, Reference)
La première trouve les titres qui commencent par le texte tapé. La seconde cherche le texte n’importe où dans les colonnes indiquées, sans tenir compte des majuscules. Quand la zone de recherche est vide, les deux renvoient toute la liste, ce qui est le comportement attendu. Avec le contrôle moderne de saisie, .Value remplace .Text.
Deux pièges ici. Dans Search, le nom de colonne s’écrit désormais sans guillemets, alors que de nombreux tutoriels montrent encore l’ancienne syntaxe. Et le tableau des opérations déléguées à SharePoint ne cite pas Search : sur une grande liste SharePoint, préférez StartsWith. Vous trouverez d’autres exemples dans la documentation de Filter, Search et LookUp.
Trier le résultat en entourant la formule :
Sort(
Filter(Demandes, Statut.Value = "En attente"),
DateDemande,
SortOrder.Descending
)
Les demandes en attente apparaissent de la plus récente à la plus ancienne. SortByColumns(Demandes, "DateDemande", SortOrder.Descending) donne le même tri : selon la documentation actuelle, le nom de colonne y reste entre guillemets.
Exploiter l’élément sélectionné
Afficher une liste n’est qu’une étape. La propriété Selected donne accès à la ligne touchée par l’utilisateur.
Afficher le détail à côté de la liste
Sur une tablette ou un ordinateur, placez un formulaire à côté de la galerie, et réglez sa propriété Item sur Galerie1.Selected. Pour une simple étiquette, écrivez Galerie1.Selected.Titre. Le détail change dès qu’on touche une autre ligne. Le formulaire doit bien se trouver à côté, et non à l’intérieur : Microsoft ne prend pas en charge les contrôles de formulaire dans une galerie. Pour le construire, voici comment concevoir un formulaire clair.
Ouvrir un écran de détail
Sur un téléphone, on ouvre plutôt un autre écran. Dans la propriété OnSelect de la galerie :
Navigate(EcranDetail, ScreenTransition.None)
L’écran EcranDetail peut lire directement Galerie1.Selected, puisque la sélection est conservée. Les notions d’écrans et de transitions sont détaillées dans notre article sur la navigation entre écrans.
Agir sur une ligne
Un bouton placé dans le modèle se répète sur chaque ligne et connaît la sienne, grâce à ThisItem. Par exemple, dans la propriété OnSelect d’une icône de corbeille :
Remove(Demandes, ThisItem)
Pour changer une seule colonne sans passer par un formulaire, comme le statut d’une demande, utilisez la fonction Patch.
Grands volumes : délégation et performances
Une galerie reliée à une grande table ne charge pas tout d’un coup : elle récupère un premier lot de lignes, puis d’autres pendant le défilement. Ce mécanisme ne fonctionne que si la formule peut être traitée par la source. C’est le principe de la délégation dans Power Apps.
Si elle ne l’est pas, Power Apps ne traite que les 500 premières lignes, et jusqu’à 10 000 après réglage dans Paramètres, Général, Limite de lignes de données. Le résultat peut alors être faux, sans erreur visible : avec le réglage par défaut, une ligne placée en 501e position ne sera jamais trouvée. Relever la limite peut aussi ralentir l’application : mieux vaut une formule déléguée. Le Studio le signale par un triangle jaune et un soulignement bleu ondulé sous la partie de la formule concernée. Ne les ignorez jamais sur une table qui peut grandir. Les règles complètes figurent dans la présentation de la délégation par Microsoft.
Quelques réflexes pour garder une galerie rapide :
- limitez le nombre de contrôles dans le modèle, car chacun est répété sur toutes les lignes affichées ;
- utilisez des fonctions déléguées, et évitez dans
Itemscelles qui ne le sont jamais, commeFirstN,LastouGroupBy; - essayez
DelayItemLoading, qui retarde le chargement des lignes jusqu’à l’affichage de l’écran, avecLoadingSpinnerpour montrer un indicateur de chargement ; - n’imbriquez une galerie dans une autre que si vous en avez vraiment besoin : le niveau d’imbrication est limité à 2, et chaque ligne déclenche un nouveau calcul ;
- évitez dans une galerie un contrôle dont le
OnChangemodifie la source de la galerie, ce qui peut provoquer un cycle de rechargement sans fin.
La page de référence du contrôle Galerie liste aussi les contrôles non pris en charge à l’intérieur : formulaires, visionneuse PDF, éditeur de texte enrichi, entre autres.
Erreurs courantes et solutions
La galerie reste vide
Vérifiez que la source contient des lignes et que l’utilisateur y a accès. Remplacez temporairement Items par le nom de la source seule : si des lignes apparaissent, c’est votre filtre qui exclut tout. Vérifiez aussi l’orthographe exacte des valeurs comparées.
Les données ne se rafraîchissent pas
Si les données ont changé hors de l’application, forcez une nouvelle lecture avec Refresh(Demandes), sur un bouton ou dans OnVisible de l’écran. Si la galerie lit une collection, c’est normal : une collection est une copie, qu’il faut recharger. Les modifications faites par un formulaire de l’application apparaissent en principe sans action de votre part.
La galerie est lente
Comptez les contrôles du modèle et cherchez les recherches dans une autre source (LookUp) placées dans chaque ligne : chacune peut déclencher une requête de plus. Mieux vaut charger la table de référence une fois, ou ajouter la colonne utile à la vue.
Tous les résultats n’apparaissent pas
Cherchez le triangle jaune de délégation. Pour tester, réglez temporairement la limite de lignes sur 1 : tout ce qui n’est pas délégué renverra une seule ligne, et le problème devient évident.
Quand une galerie mérite le regard d’un expert
Une liste filtrée sur quelques centaines de lignes ne pose aucune difficulté, et vous pouvez la construire seul avec cette page. Le besoin d’un regard expérimenté apparaît quand la table dépasse la limite de délégation et que le filtre utile ne se délègue pas, quand l’écran devient lent à cause de galeries imbriquées, ou quand des droits différents doivent s’appliquer selon le service. Le remède se trouve alors souvent dans la structure des données, et pas dans la galerie. Pour replacer ce choix dans un projet complet, voyez ce que permet une application métier Power Apps.
Questions fréquentes
Combien d’éléments une galerie peut-elle afficher ?
Avec une formule déléguée, elle peut parcourir de très grandes tables, car les lignes arrivent au fil du défilement. Avec une formule non déléguée, seules les 500 premières lignes de la source sont prises en compte, ou jusqu’à 10 000 après réglage. La propriété AllItemsCount indique seulement le nombre de lignes déjà chargées, pas le total de la source.
Peut-on imbriquer des galeries ?
Oui, en plaçant une galerie dans le modèle d’une autre, par exemple des commandes puis leurs lignes. Le niveau maximal d’imbrication est de 2 : une galerie déjà imbriquée ne peut pas en recevoir une autre. Cette construction ralentit vite l’écran, à tester avec un volume réel.
Comment afficher un message quand la galerie est vide ?
Ajoutez une étiquette avec votre message, et réglez sa propriété Visible sur Galerie1.AllItemsCount = 0. Elle apparaît uniquement quand aucune ligne n’est chargée, par exemple après une recherche sans résultat. Pensez à proposer un moyen de vider le filtre.
Peut-on ajouter un bouton d’action sur chaque ligne ?
Oui, insérez le bouton dans le modèle de la galerie : il se répète sur chaque ligne. Dans sa propriété OnSelect, ThisItem désigne la ligne concernée, ce qui permet par exemple de la supprimer ou de changer son statut. Évitez d’en mettre trop, car chaque contrôle alourdit l’affichage.
Comment afficher des images dans une galerie ?
Placez un contrôle Image dans le modèle et réglez sa propriété Image sur la colonne qui contient l’image ou son adresse, par exemple ThisItem.Photo. La propriété ImagePosition gère le recadrage. Préférez des images légères, car un grand nombre de photos en pleine résolution ralentit le défilement.
À lire ensuite
- Intégrer Power Apps dans Microsoft TeamsAfficher une application métier dans Teams évite à vos équipes de retenir une adresse de plus. Les façons de le faire, les étapes à suivre, les droits à vérifier et les pièges courants.9 min
- Concevoir des formulaires intuitifs dans Power AppsUn formulaire clair donne des données propres, un formulaire confus donne des ressaisies. Comment choisir les contrôles, organiser les champs et valider les saisies avec de vraies formules.9 min
- Créer votre première application Canvas en 30 minutesUne application Canvas se dessine comme une diapositive, puis se relie à vos données. Suivez ces cinq étapes pour obtenir une première version utilisable, avec les vraies formules.8 min
- Power Apps Model-driven vs Canvas : Quelle approche choisir ?Deux façons de construire une application Power Apps : à partir de vos données ou à partir d’un écran vide. Voici comment choisir selon votre processus, vos équipes et vos licences.8 min