Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

terme ou valeur HTML: contenteditable

L’attribut `contenteditable` active ou désactive la modification du contenu d’un élément, sans créer un contrôle de formulaire ni assurer seul un enregistrement sûr.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<section contenteditable="true">…</section>

contenteditable est énuméré et non booléen : la valeur vide et true activent l’édition, false la désactive et plaintext-only limite les opérations au texte brut. Une valeur absente ou invalide hérite de l’ancêtre.

La propriété contentEditable décrit la déclaration et renvoie inherit pour une valeur absente ou invalide ; isContentEditable donne l’état calculé dans le contexte. Un descendant peut donc être modifiable malgré son propre jeton invalide.

Un hôte d’édition imbriqué n’entre normalement pas séparément dans l’ordre de tabulation ; ajoutez tabindex="0" pour en faire une cible autonome. Les modifications changent le DOM, ne sont pas envoyées automatiquement par un formulaire et le HTML conservé doit être assaini ; le mode texte modifie aussi le collage.

L’exemple place contenteditable="invalid" sous un parent modifiable : contentEditable renvoie inherit, tandis que isContentEditable renvoie true. Il montre la limite entre déclaration et état hérité.

Exemples

<!doctype html><meta charset="utf-8"><div id="p" contenteditable="true"><span id="x" contenteditable="invalid">Text</span></div><output id="result"></output><script>result.textContent=`parent=${p.isContentEditable}; child=${x.isContentEditable}; raw=${x.contentEditable}`;</script>

Résultat

parent=true; child=true; raw=inherit

L’exemple exécuté vérifie l’édition héritée pour un descendant au jeton invalide et distingue les deux vues IDL.

Sources