# Editeur de texte enrichi

> Intégrez un éditeur de texte enrichi dans votre application pour permettre à vos utilisateurs de prendre des notes avec mise en forme. Découvrez comment sauvegarder le contenu localement ou dans Firebase.

https://docs.pandasuite.com/fr/essentials/components/text-editor/

**Le composant Éditeur de texte permet à vos utilisateurs de prendre des notes efficacement et de manière interactive directement dans votre application.**

Cette fonctionnalité est idéale pour :

- **Applications de e-learning** : permettre aux apprenants d'annoter leurs cours
- **Journaux personnels** : offrir un espace d'expression libre
- **Applications de prise de notes** : créer des notes enrichies avec mise en forme
- **Formulaires avancés** : capturer des réponses détaillées

> **Info : Sauvegarde du contenu**
>
> Le contenu de l'éditeur **n'est pas sauvegardé automatiquement**. Pour
> conserver les notes entre les sessions, vous devez mettre en place une
> solution de persistance : en local avec le
> [Datastore](https://docs.pandasuite.com/fr/essentials/data/datastore/) ou à distance via
> [Firebase](https://docs.pandasuite.com/fr/essentials/integrations/save-user-data-in-firebase/).

[Image : Éditeur de texte avec une barre d'outils gras, italique, barré, lien, annuler et rétablir, et le mot HELLO saisi en italique]

## Insérer l'éditeur de texte

Pour intégrer l'éditeur de texte dans votre projet :

1. Accédez à l'onglet **Composants**.
2. Sélectionnez et insérez le composant **Éditeur de texte**.
3. Glissez et déposez le composant à l'emplacement désiré sur votre interface.

## Options de style

L'éditeur de texte offre une multitude d'options pour personnaliser le style et l'apparence du texte, afin d'adapter l'interface à l'identité visuelle de votre application.

[Image : Éditeur de texte sur un écran Garden notes : Toolbar sur Yes et les options Header, Style, Color, Align, Clean et History activées, encadrées]

Pour utiliser ces options :

1. Dans les propriétés du composant, cliquez sur **Oui** pour activer la **Barre d'outils**.
2. Sélectionnez les éléments à afficher sur la barre d'outils :
   - **En-tête** : choix de taille et de format pour les titres.
   - **Style** : gras, italique, souligné.
   - **Bloc** : citation, code.
   - **Média** : ajout d'images ou de vidéos.
   - **Liste** : création de listes à puces ou numérotées.
   - **Script** : superscript ou subscript.
   - **Indentation** : augmenter ou diminuer l'indentation.
   - **Direction** : alignement du texte à gauche, à droite, ou centré.
   - **Couleur** : sélection de la couleur de texte ou d'arrière-plan.
   - **Police** : choix de la police de caractères.
   - **Alignement** : alignement du texte dans le bloc.
   - **Nettoyer / Historique** : options pour nettoyer la mise en forme ou annuler/refaire les modifications.

Vous pouvez également définir un **Texte par défaut** et utiliser le data binding pour lier le contenu de l'éditeur à une variable ou à une autre propriété dans votre application.

## Déclencheurs

Voici la liste des déclencheurs disponibles depuis le composant :

- **Validé** : se déclenche quand le contenu est validé (manuellement ou si **Validation auto** est activée).
- **Ciblé** : se déclenche quand l'éditeur reçoit le focus (est ciblé par l'utilisateur).
- **Perte de focus** : se déclenche quand l'éditeur perd le focus (l'utilisateur clique en dehors de l'éditeur).

## Conserver le contenu entre les sessions

Par défaut, le contenu de l'éditeur n'est pas sauvegardé. Pour le conserver entre les sessions, deux options s'offrent à vous :

### Sauvegarde locale (Datastore)

Idéale pour des notes personnelles sans synchronisation multi-appareils.

1. Créez un [Datastore](https://docs.pandasuite.com/fr/essentials/data/datastore/) avec une propriété de type **Clé / Valeur** (pour le contenu enrichi) ou **Texte** (pour du texte simple).
2. Activez **Validation auto** dans les propriétés de l'éditeur.
3. Sur le déclencheur **Validé**, utilisez **Agir sur une source de données → Datastore → Créer/modifier une donnée (local)** et définissez la valeur avec le **Contenu** de l'éditeur.
4. Au chargement de l'écran, utilisez **Agir sur un composant → Éditeur de texte → Définir le contenu** en passant la valeur depuis votre base.

> **Info : Limitations**
>
> Les données locales sont liées au lien de publication et au profil du
> navigateur. Elles ne seront pas retrouvées en navigation privée ou après
> désinstallation de l'app.

### Sauvegarde à distance (Firebase)

Idéale pour la synchronisation multi-appareils et la sauvegarde cloud.

**Prérequis** : [Projet Firebase](https://docs.pandasuite.com/fr/essentials/integrations/create-a-firebase-project/) configuré avec le composant **Firebase Session** et authentification active.

1. Sur le déclencheur **Validé**, utilisez **Agir sur une source de données → Session Firebase → Modifier la donnée**. Définissez le champ qui stocke votre note comme **Cible**, choisissez la **Fonction** **Définir**, puis utilisez le **Contenu** de l'éditeur comme **Valeur**.
2. Au chargement de l'écran, utilisez **Agir sur un composant → Éditeur de texte → Définir le contenu** en passant la valeur depuis Firebase.

> **Info : Avantages et limites**
>
> - **Avantages** : synchronisation automatique, sauvegarde cloud, accessible
>   après réinstallation. - **Limites** : nécessite une connexion internet et une
>   authentification utilisateur.

## Agir sur l'éditeur de texte

Sélectionnez un objet déclencheur, cliquez sur **Actions** et créez une nouvelle action.

Choisissez votre **déclencheur** (par exemple au simple tap) et l'action **Agir sur un composant**.

Sélectionnez votre composant **Éditeur de texte**. Voici les actions disponibles :

- **Valider**
- **Définir le texte**
- **Définir le contenu** (à privilégier pour le contenu enrichi et la restauration de notes sauvegardées)
- **Supprimer le texte / contenu**
- **Cibler le texte**

En intégrant l'**Éditeur de texte** dans votre application, vous offrez à vos utilisateurs un outil puissant pour la création et la gestion de contenu textuel. Grâce à sa personnalisation étendue et ses options interactives, vous pouvez créer une expérience utilisateur enrichissante et adaptée à vos besoins spécifiques.
