# Galerie

> Découvrez comment utiliser le composant Galerie pour faire défiler des pages avec des effets de slide.

https://docs.pandasuite.com/fr/essentials/components/gallery/

**Le composant Galerie permet d'afficher une série d’images ou de contenus multimédias de manière dynamique et interactive. Il est idéal pour concevoir des portfolios, des diaporamas, des carrousels d’images, ou encore des présentations de produits. Il peut contenir des images, des formes, des textes et même d'autres composants.**

[Vidéo : Exemple de galerie sur une tablette : un tap sur les flèches ou un swipe sur l'image fait passer d'une photo à l'autre]

## Cas d'utilisation

- **Portfolios créatifs** : présentation de projets visuels ou photographiques.

- **Carrousels de produits** : affichage interactif de produits avec description associée.

- **Diaporamas animés** : présentations illustrées avec des animations intégrées.

- **Audioguides ou visites virtuelles** : navigation entre plusieurs points d'intérêt visuels ou multimédia.

- **Catalogues interactifs** : consultation d’un ensemble de pages ou d’images.

## Mise en place du composant

### Insertion dans le projet

Cliquez sur **Composants** et insérez le composant **Galerie**.

Placez le composant à l'endroit souhaité sur votre espace de travail.

### Création des pages

Le composant Galerie est composé de pages. L'utilisateur(rice) swipe avec son doigt ou sa souris pour passer d'une page à l'autre.
Par défaut, il contient une seule page.

Double-cliquez sur la zone pour éditer et ajouter des pages.

Cliquez sur le bouton **+** pour ajouter des pages.

[Image : Dans le composant Galerie, la liste Pages compte trois pages et le bouton + qui sert à en ajouter ; la page 1 contient une photo]

Vous pouvez insérer toutes sortes d'objets à l'intérieur des pages.

> **Info**
>
> 💡 Le composant **Galerie** peut également être utilisé pour ajouter un effet
> de « slide » entre des écrans. Auquel cas, agrandissez la taille de la galerie à
> la taille de votre écran et insérez tout le contenu de vos écrans à
> l'intérieur.

## Caractéristiques du composant

### Propriétés

Voici les propriétés du composant Galerie :

- **Interaction utilisateur** : cette option permet de prendre en compte les interactivités définies sur et dans le composant.
- **Orientation** (**Horizontale** / **Verticale**) : choisissez entre un défilement horizontal ou vertical.
- **Défilement utilisateur** (**Oui** / **Non**) : activez ou non le défilement des pages par l'utilisateur.
- **Page par défaut** : sélectionnez la page qui s'affiche automatiquement au chargement de la galerie. Par défaut la galerie conserve la dernière page.

[Image : Propriétés du composant Galerie : Orientation sur Horizontale, Défilement utilisateur sur Oui et aucune Page par défaut choisie]

### Propriétés exposées

La Galerie expose une valeur que vous pouvez [lier](https://docs.pandasuite.com/fr/essentials/data/data-binding/) à d'autres composants. Dans la fenêtre de données, choisissez **Depuis un composant**, puis la Galerie :

- **Index courant** : la position de la page affichée, un nombre qui commence à `0` pour la première page. C'est une position, pas le nom ni l'identifiant de la page, et elle se met à jour à chaque changement de page.

Par exemple, pour afficher le numéro de la page courante, liez le **Contenu** d'un texte à l'**Index courant** et ajoutez la fonction [Add](https://docs.pandasuite.com/fr/essentials/data/functions/#add) avec le nombre `1`, afin que la première page affiche `1`.

### Événements déclencheurs

Vous pouvez utiliser le composant Galerie pour déclencher une action.

Sélectionnez votre composant et ouvrez la fenêtre **Actions**. Cliquez sur le bouton **+** pour afficher la liste des déclencheurs :

- **Affichage page**
- **Tape/Clic**
- **Double tape/clic**
- **Touche**
- **Relâche**
- **Glisse vers le haut**, **Glisse vers le bas**, **Glisse vers la droite**, **Glisse vers la gauche**
- **Survol entrant**, **Survol sortant**

### Actions interactives

Vous pouvez également créer une action sur le composant Galerie.

Choisissez le déclencheur de votre choix et l'action **Agir sur un composant**. Sélectionnez le composant **Galerie** et voici la liste des actions disponibles :

- **Sélectionner une page**
- **Page suivante**
- **Page précédente**
- **Page aléatoire**

## Exemples pratiques

### Créer un bouton pour passer d'une page à l'autre de la galerie

Sélectionnez votre bouton et, dans l'onglet **Actions**, choisissez le déclencheur **Tape/Clic** et l'action **Agir sur un composant**. Sélectionnez la Galerie, puis **Page suivante** ou **Page précédente**.

### Faire défiler la galerie automatiquement

Pour faire défiler votre galerie automatiquement, vous pouvez ajouter un composant [Minuteur](https://docs.pandasuite.com/fr/essentials/components/timer/) et un composant **Synchronisation** pour synchroniser les valeurs de temps avec les pages de la galerie.

Vous pouvez [synchroniser](https://docs.pandasuite.com/fr/essentials/components/synchronization/) votre galerie avec n'importe quel autre composant.

### Ouvrir les images de la galerie en plein écran

Si vous souhaitez ouvrir les images en plein écran, utilisez le composant Pop-up.

Sélectionnez votre image et ajoutez-lui une action **Tape/Clic** qui lance **Ouvrir la pop-up** sur le composant [Pop-up](https://docs.pandasuite.com/fr/essentials/components/pop-up/).

Dans cet exemple, une autre galerie est synchronisée à l'intérieur de la pop-up.

[Image : Page 1 de la galerie : la photo porte une action au clic qui lance Ouvrir la pop-up]

[Modèle : Galerie + Pop-up plein écran](https://pandasuite.com/dashboard/use-template/szYpEJYBaHn0WhDCQmQF)
