# Comprendre les composants

> Découvrez le guide complet sur l'ajout et la gestion des composants dans PandaSuite, y compris les types de composants, leurs caractéristiques, et comment les personnaliser pour améliorer vos applications PandaSuite.

https://docs.pandasuite.com/fr/getting-started/understand-components/

**Découvrez le pouvoir des composants et ce que vous pouvez réaliser avec eux.**

[Vidéo : Présentation des composants de PandaSuite et de ce que vous pouvez réaliser avec eux](https://www.youtube.com/embed/YbhVTMUZtbw?&hl=fr&cc_lang_pref=fr&cc_load_policy=1)

## Tout est composant

Dans PandaSuite, chaque fonctionnalité est représentée par un composant : la [Pop-up](https://docs.pandasuite.com/fr/essentials/components/pop-up/), la [Zone de défilement](https://docs.pandasuite.com/fr/essentials/components/scrolling-area/), le [GPS](https://docs.pandasuite.com/fr/essentials/components/gps-geo-fencing/)... Ainsi chaque fonctionnalité est flexible, personnalisable et synchronisable avec une autre fonctionnalité. C'est ainsi que PandaSuite vous offre la plus grande liberté de création. 🚀

Comme des Legos®, chaque composant est composé de la même façon, sous la forme d’un principe commun, abstrait, qui permet la connexion entre eux, sans être spécifique à ces mêmes composants.

Il existe plusieurs types de composants :

- des composants graphiques ([Image HD](https://docs.pandasuite.com/fr/essentials/components/hd-image/), [Drag & Drop](https://docs.pandasuite.com/fr/essentials/components/drag-and-drop/)...),
- des composants de mise en page ([Flexbox](https://docs.pandasuite.com/fr/essentials/components/flexbox/), [Groupe](https://docs.pandasuite.com/fr/essentials/components/group/)...),
- des composants système ([GPS](https://docs.pandasuite.com/fr/essentials/components/gps-geo-fencing/), [Capteur beacon](https://docs.pandasuite.com/fr/essentials/components/beacon-sensor/), [Capteur mouvement](https://docs.pandasuite.com/fr/essentials/components/motion-sensor/))
- et des composants données ([Collection / Liste](https://docs.pandasuite.com/fr/essentials/data/collection/), [Authentification](https://docs.pandasuite.com/fr/essentials/components/authentication/)...).

[Image : Liste ouverte par l'icône Composants : Galerie, Multi-état, Pop-up, Web…, puis Groupe, Zone de défilement, Flexbox, et les capteurs]

Cliquez sur l'icône Composants pour accéder à la liste complète

Vous pouvez ajouter des composants où vous voulez dans votre application : dans un [écran](https://docs.pandasuite.com/fr/essentials/layout/screens/), dans un [avant-plan](https://docs.pandasuite.com/fr/essentials/project-properties/foreground-and-background/) et même au niveau du projet. Lorsqu'un composant est ajouté au niveau du Projet, il est actif tout au long de l'application (ce qui peut être utile pour un [Minuteur](https://docs.pandasuite.com/fr/essentials/components/timer/) ou le composant [HTTP](https://docs.pandasuite.com/fr/essentials/components/http/)).

Quand vous ajoutez un composant, celui-ci apparaît dans la liste des Objets en bas à gauche. Les composants non visuels sont isolés des autres composants par un séparateur et ils sont placés en bas de la liste. Vous pouvez renommer vos composants.

[Image : Liste des objets de l'écran Invite : pop-up, bouton, saisie de texte et fond, puis le composant HTTP SMS request sous le séparateur]

Le composant HTTP, non visuel, se place sous le séparateur, en bas de la liste des objets

## Caractéristiques d'un composant

Tous les composants possèdent ces mêmes caractéristiques :

- des propriétés
- des événements [déclencheurs](https://docs.pandasuite.com/fr/essentials/interactions/triggers/) pour lancer une action
- des [actions](https://docs.pandasuite.com/fr/essentials/interactions/interactive-actions/) qui peuvent lui être attribuées
- des [marqueurs](https://docs.pandasuite.com/fr/essentials/interactions/markers/)
- la possibilité d'être [synchronisé](https://docs.pandasuite.com/fr/essentials/components/synchronization/) avec un autre composant
- la possibilité de réagir en fonction des [langues](https://docs.pandasuite.com/fr/essentials/project-properties/languages-and-localization/)
- des [données](https://docs.pandasuite.com/fr/essentials/data/dynamic-content/)

## Édition d'un composant

Pour éditer le contenu d'un composant, il faut rentrer à l'intérieur de ce composant : il y a une notion de profondeur.

Pour entrer à l'intérieur, double-cliquez sur le composant. Ce composant devient le contexte. Le fil d'Ariane, en haut de votre écran, vous permet de vous situer dans votre navigation et de sortir de ce composant.

À l'intérieur d'un composant visuel, vous pouvez ajouter toutes sortes de contenus : images, texte, etc. Vous pouvez même ajouter un ou plusieurs composants et créer des imbrications avancées.

[Image : Dans un groupe : le fil d'Ariane indique 6. Garden map > Multi-state18029 - closed > Group18373, et la liste montre les objets du menu]

Ici, vous êtes à l'intérieur d'un Groupe, lui-même dans un Multi-état

Vous pouvez créer des [marqueurs](https://docs.pandasuite.com/fr/essentials/interactions/markers/) sur vos composants, c'est-à-dire d'identifier un ou plusieurs comportements spécifiques de ce composant et de l'utiliser pour une action. Cela peut être le temps d'une vidéo, une position de défilement, un degré d'inclinaison etc.

Rendez-vous dans la fenêtre de gauche pour éditer et gérer vos marqueurs.

[Image : Panneau Marqueurs à gauche, dans un composant Web : le marqueur New year 2021 et son identifiant, avec ses propriétés à droite]

Ce marqueur du composant Web déclenche une action à une date donnée

## Propriétés d'un composant

Les propriétés sont spécifiques à chaque composant : source, lecture automatique, orientation, marge...

Éditez les propriétés depuis la fenêtre de droite.

[Image : Propriétés de la Saisie de texte à droite : contenu, type, texte générique, taille, alignement, couleur et validation en direct]

Voici les propriétés de la Saisie de texte

## Actions d'un composant

Votre composant peut servir de déclencheur à une action.

Pour déclencher une action à partir d'un composant, sélectionnez ce composant et cliquez sur **Actions**.

Choisissez un événement déclencheur parmi la liste : certains événements sont spécifiques au composant et d'autres communs à tous les composants.

[Image : Déclencheurs du Multi-état dans la fenêtre Action : affichage de l'état 1 - closed et de l'état 2 - open, puis Tape/Clic, Double tape/clic…]

Les déclencheurs du Multi-état incluent l'affichage de chaque état

Votre composant peut également être l'objet d'une action. Lorsque vous avez choisi votre événement déclencheur, sélectionnez l'action **Agir sur un composant** > sélectionnez ce composant et choisissez une action.

[Image : Agir sur un composant ciblant un Multi-état, au tape clic d'un bouton, avec Sélectionner un état, État suivant, État précédent, État aléatoire]

Les actions possibles sur le Multi-état

## Synchroniser des composants

La [synchronisation](https://docs.pandasuite.com/fr/essentials/components/synchronization/) permet de synchroniser plusieurs composants entre eux. Vous pouvez par exemple synchroniser un composant Audio avec une Zone de défilement pour faire défiler un contenu en même temps que la musique. Ou synchroniser deux Zones de défilement ensemble (ou plus) pour réaliser un effet Parallaxe.

Insérez un composant Synchronisation et créez un groupe de synchronisation avec vos composants.

[Image : Propriétés de la Synchronisation : zones de défilement Background et Clouds liées par leur position horizontale, Birds par la verticale]

Cette synchronisation entre 3 zones de défilement permet de réaliser un effet Parallaxe

## Créer un composant sur-mesure

Si vous êtes développeur(se) et que vous souhaitez ajouter de nouvelles fonctionnalités, vous pouvez créer vos propres [Composants personnalisés](https://docs.pandasuite.com/fr/essentials/components/custom-components/).

Nous mettons à votre disposition nos librairies PandaBridge (JavaScript & React) qui permettent d'envoyer et de recevoir des informations entre votre code et PandaSuite.
