Documentation
Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Personnalisation

Éditeur de texte enrichi

Rédiger et mettre en forme du texte dans les champs Éditeur de texte, y insérer des images et des tableaux, et adapter la barre d'outils par script.

Éditeur de texte enrichi

Les champs de type Éditeur de texte affichent un éditeur avec une barre d'outils. Vous l'utilisez par exemple pour la description d'un article, une note ou le corps d'un e-mail. Le contenu est enregistré en HTML.

Barre d'outils

Survolez un bouton pour voir son nom et son raccourci clavier.

GroupeOutils
Style« Style de texte » (Paragraphe, Titre 1 à Titre 6), « Taille de police »
Mise en forme« Gras » (Ctrl+B), « Italic » (Ctrl+I), « Souligner » (Ctrl+U), « Barrer », « Supprimer le formattage »
Couleurs« Couleur du texte », « Couleur de fond »
Blocs« Citation », « Bloc de code », « Direction du texte »
Insertion« Insérer un lien », « Insérer une image »
Listes« Liste numérotée », « Liste à puce », « Liste de tâches »
Mise en page« Alignement », « Diminuer l'indentation », « Augmenter l'indentation »
Tableau« Insérer un tableau », ajout et suppression de lignes et de colonnes, « Supprimer le tableau »

Dans une ligne de table enfant, l'éditeur s'affiche sans barre d'outils, faute de place.

Une URL tapée ou collée devient un lien automatiquement.

Insérer une image

  1. Placez le curseur à l'endroit voulu.
  2. Cliquez sur « Insérer une image » et choisissez un fichier. Vous pouvez aussi coller une image.
  3. Cliquez sur l'image pour afficher les poignées. Faites-les glisser pour la redimensionner.

Les formats PNG, JPEG, GIF et WebP sont acceptés. Pour supprimer une image, cliquez dessus puis appuyez sur Suppr ou Retour arrière.

À l'enregistrement du document, Dodock transforme chaque image collée dans le texte en document Fichier joint au document. Le fichier est privé, sauf si le type de document rend ses pièces jointes publiques.

Texte indicatif

Un éditeur vide affiche « Tapez quelque chose... ». Pour un autre texte, renseignez la propriété « Placeholder » du champ dans Personnaliser un formulaire.

Mentions

Dans les commentaires, tapez @ puis le début d'un nom pour mentionner un utilisateur. L'utilisateur mentionné reçoit une notification.

Adapter la barre d'outils (développeurs)

Un script peut remplacer la barre d'outils d'un champ en définissant get_toolbar_options sur sa définition. La fonction renvoie la liste des groupes de boutons, au format de la barre d'outils Quill.

// Exemple fictif : barre réduite pour le champ « description » de l'article
frappe.ui.form.on("Item", {
    setup(frm) {
        frm.get_docfield("description").get_toolbar_options = () => [
            ["bold", "italic", "underline"],
            [{ list: "ordered" }, { list: "bullet" }],
            ["link"],
        ];
    },
});

Résoudre les problèmes courants

ProblèmeCause probable
La barre d'outils n'apparaît pasLe champ est dans une ligne de table enfant, ou il est en lecture seule.
Une mise en forme disparaît à l'impressionLe format d'impression applique ses propres styles. Vérifiez le rendu dans l'aperçu avant impression.