# Collection

> Découvrez comment afficher les données de votre collection sous forme de liste en connectant votre application à une source de données et en utilisant les composants PandaSuite pour un rendu dynamique et interactif.

https://docs.pandasuite.com/fr/essentials/data/collection/

**Affichez les données de votre collection sous la forme d’une liste.**

Une Collection est l’équivalent piloté par les données d’une [Flexbox](https://docs.pandasuite.com/fr/essentials/components/flexbox/) : elle dispose ses éléments répétés le long d’un axe principal, horizontal ou vertical, de la même façon. Vous réglez la direction et l’espacement, le conteneur place chaque élément, et les éléments se suivent sans se superposer.

[Vidéo : Tutoriel Collection / Liste : afficher les données d'une collection sous forme de liste dans une application PandaSuite](https://www.youtube.com/embed/ZlEOUxwcYTE?&hl=fr&cc_lang_pref=fr&cc_load_policy=1)

## Connecter la source de données

Pour connecter votre collection à une source de données :

- Insérez le composant **Collection / Liste**.
- Dans les propriétés, cliquez sur **Source** et choisissez **Depuis une source de données**. Sélectionnez votre source de données, puis la liste à afficher (ici, les **records** d'Airtable).
- Cliquez sur le bouton **Valider**.

> **Info : Le type de source compte**
>
> Ce qu'un composant **Collection / Liste** expose dans le data binding dépend
> de sa source. Avec une **Collection**, la fenêtre ajoute **Élément courant**,
> une **Référence** vers la ligne, avec accès à ses champs et à son identifiant.
> Avec un **Tableau**, elle ajoute **Index courant** (la position de la ligne) à
> la place. Voir
> [Élément courant](https://docs.pandasuite.com/fr/essentials/data/data-binding/#élément-courant) et
> [Index courant](https://docs.pandasuite.com/fr/essentials/data/data-binding/#index-courant).

[Vidéo : Source de la Collection / Liste, Depuis une source de données, puis le composant Airtable et son tableau records (22 lieux), et Valider]

> **Attention**
>
> Au préalable, votre application doit être connectée à une source de données. Pour une API telle qu'Airtable, vous avez besoin du composant HTTP. Découvrez comment faire : [Se connecter à Airtable](https://docs.pandasuite.com/fr/essentials/integrations/connect-to-airtable/). Testez la requête et lancez la requête à l'affichage de l'écran dans lequel se trouve votre composant.

## Créer un élément de liste

Dans la collection, un seul élément sera créé et répété à partir des données de la source.

Personnalisez le design de cet élément : card, texte sur une ligne... Double-cliquez sur le composant pour éditer son contenu.

Si vous utilisez un outil de design, exportez chaque élément individuellement pour qu'il puisse être connecté dynamiquement à une donnée.

> **Info**
>
> 💡 Si vous souhaitez de l'inspiration pour l'UI de vos éléments de liste :
> [Guide to list UI design: principles and examples](https://www.justinmind.com/blog/list-ui-design/)

Insérez un composant [Groupe](https://docs.pandasuite.com/fr/essentials/components/group/). Ajustez sa taille et à l’intérieur, représentez visuellement un élément de liste.

[Image : Gabarit d'élément de liste dans la Collection / Liste : un Groupe, encadré, contenant la carte avec arrondissement, image et nom du lieu]

Maintenant que votre gabarit est prêt, affichez dedans les champs de la base (*Name*, *Address*, *Description*, *Image*, *Category*...) grâce au [data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/).

[Image : Table City Guide dans Airtable : 9 lieux parisiens avec les champs Name, Address, Arrondissement, Description, Image et Category]

## Binder un texte

Pour afficher le champ *Name* dans un bloc de texte, sélectionnez ce bloc de texte, cliquez sur **Éditer** à côté de **Contenu**, sélectionnez le texte et cliquez sur **Insérer de la donnée**. Cliquez ensuite sur l'étiquette **Donnée** qui le remplace pour ouvrir la fenêtre de [data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/).

Sélectionnez **Élément courant** et parcourez votre source de données. Avec un tableau comme les **records** d'Airtable, la fenêtre propose **Index courant** à la place : ouvrez la ligne courante, puis ses champs.

**Élément courant** est une référence vers la ligne en cours d'affichage dans la collection : ouvrez l'un de ses champs pour lier la valeur de ce champ, ou arrêtez-vous dessus pour utiliser l'identifiant de l'élément. Pour en savoir plus : [Data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/#élément-courant).

[Vidéo : le titre de la carte reçoit Insérer de la donnée, puis Index courant, la ligne courante, fields et Name (Rosa Bonheur), et Valider]

> **Info**
>
> 💡 En choisissant **Élément courant**, vous accédez directement aux données de la ligne courante, ici à une ligne de la base Airtable : *Rosa Bonheur*.

## Binder une image

Sur Airtable, les images sont exposées sous la forme d'un URL qui est ensuite automatiquement convertie en image par PandaSuite.

Sélectionnez l’image, survolez **Source** et cliquez sur l'icône de [data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/) qui apparaît.

[Vidéo : la Source de l'image de la carte reçoit Index courant, la ligne courante, fields, Image, le premier élément et son champ url, et Valider]

## Conditions d'affichage

Les conditions d’affichage sont une fonctionnalité avancée permettant de sélectionner automatiquement l’élément à afficher en fonction d’une condition spécifique. Cette option devient disponible dès lors qu’un deuxième élément est ajouté dans le composant **Collection / Liste**. Elle est particulièrement utile lorsque le design ou la structure d’un élément doit s’adapter à la nature des données connectées.

Par exemple, vous pouvez afficher un élément Image ou Vidéo selon la valeur d’un champ Type dans votre source de données. Dans le template [Catalogue immobilier](https://pandasuite.com/fr/templates/app-immobilier/), cette fonctionnalité est utilisée pour indiquer si un bien immobilier est exclusif ou non, en se basant sur un champ booléen.

[Image : Catalogue immobilier : la condition d'affichage Exclusivity? de la liste montre l'élément card exclusivity, avec son badge EXCLUSIVITY]

> **Info**
>
> 💡 Astuce : Si vous souhaitez rendre conditionnelle uniquement une partie d’un élément sans recourir aux conditions d’affichage globales, insérez simplement [le composant Condition](https://docs.pandasuite.com/fr/essentials/components/condition/) à l’intérieur de l’élément. Cela vous permettra d’ajouter des actions spécifiques basées sur un multi-état.

## Combiner affichage statique et dynamique grâce aux conditions d’affichage

Il est possible de mixer des sources de données dynamiques et des éléments statiques pour répondre à différents besoins d’interactivité. Vous pouvez ainsi conserver un affichage statique pour des éléments nécessitant une interactivité spécifique et non générique (tirant parti des nombreuses fonctionnalités interactives de PandaSuite), tout en créant des pages dynamiques grâce au [data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/) pour un affichage standard.

Les conditions d’affichage jouent ici un rôle clé pour gérer ces deux types d’éléments. Vous pouvez utiliser cette fonctionnalité pour cibler des éléments statiques et leur associer un renderer spécifique. Par exemple, [le composant Condition](https://docs.pandasuite.com/fr/essentials/components/condition/) peut vérifier l’identifiant de la donnée source et rediriger vers la bonne page statique.

Inversement, il est également possible de mettre à jour votre contenu dynamique pour inclure les identifiants uniques des écrans et les exploiter dans une action de changement d’écran. En liant ces identifiants via le data binding, vous pouvez ainsi créer une navigation fluide et cohérente entre vos données dynamiques et vos éléments statiques.
