Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje