CKTIS / HTML
termín nebo hodnota HTML: contenteditable
Atribut `contenteditable` zapíná či vypíná úpravy obsahu prvku, ale nevytváří formulářový ovládací prvek ani sám nezajišťuje bezpečné uložení.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<section contenteditable="true">…</section>contenteditable je výčtový, nikoli booleovský atribut: prázdná hodnota a true úpravy zapnou, false je vypne a plaintext-only omezí operace na prostý text. Chybějící nebo neplatná hodnota dědí stav od předka.
Vlastnost contentEditable popisuje deklaraci a pro chybějící či neplatnou hodnotu vrací inherit; isContentEditable vrací vypočtený stav v kontextu. Potomek tedy může být upravitelný navzdory vlastnímu neplatnému tokenu.
Vnořený editační hostitel obvykle není samostatně v pořadí tabulátoru; má-li být nezávislým cílem, přidej tabindex="0". Úpravy mění DOM, neodesílají se automaticky s formulářem a uložené HTML je nutné čistit; režim prostého textu mění i vkládání.
Příklad umístí contenteditable="invalid" pod upravitelný rodič: contentEditable vrátí inherit, zatímco isContentEditable vrátí true. Ukazuje hranici mezi deklarací a zděděným stavem.
Příklady
<!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>Výsledek
parent=true; child=true; raw=inherit
Spuštěný příklad ověřuje zděděnou upravitelnost potomka s neplatným tokenem a rozlišuje oba pohledy IDL.