Attribut global HTMLAttributs globaux

contenteditable

Permet à l’utilisateur de modifier le contenu de l’élément directement sur la page.

S’applique à
Tous les éléments HTML
Sur cette page

Exemple

#
HTML
<p contenteditable="true" style="padding: 12px; border: 1px dashed #555; border-radius: 10px;">
  Cliquez et modifiez ce texte. Vous pouvez aussi y ajouter quelque chose de votre cru.
</p>
Aperçu

Définition et utilisation

#

L’attribut contenteditable transforme un élément ordinaire en zone d’édition. L’utilisateur peut cliquer dans le texte, le corriger, ajouter de nouveaux paragraphes, et même coller du contenu mis en forme.

Les éditeurs de texte dans le navigateur, les blocs-notes et les outils de commentaires reposent sur ce mécanisme. La modification du contenu n’est enregistrée nulle part d’elle-même : c’est à JavaScript de s’en charger, par exemple en écoutant l’événement input.

La valeur plaintext-only permet de ne modifier que du texte brut, sans mise en forme. C’est une valeur plus récente, arrivée depuis peu dans tous les principaux navigateurs.

Syntaxe

#
Syntaxe
<element contenteditable="true | false | plaintext-only">…</element>

Valeurs

#
  • true

    ou vide

    Le contenu peut être modifié, mise en forme comprise.
  • false

    Le contenu ne peut pas être modifié, même si le parent est modifiable.
  • plaintext-only

    Seul le texte brut peut être modifié, la mise en forme est rejetée.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Pour les formulaires ordinaires, utilisez <input> et <textarea>. contenteditable est plus difficile à gérer et à valider.
  • Nettoyez toujours le contenu collé par l’utilisateur avant de l’enregistrer sur le serveur.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.