CKTIS / HTML
termín alebo hodnota HTML: contenteditable
Atribút `contenteditable` zapína alebo vypína úpravy obsahu prvku, ale nevytvára formulárový ovládací prvok ani sám nezabezpečuje bezpečné uloženie.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<section contenteditable="true">…</section>contenteditable je výpočtový, nie booleovský atribút: prázdna hodnota a true úpravy zapnú, false ich vypne a plaintext-only obmedzí operácie na obyčajný text. Chýbajúca alebo neplatná hodnota dedí stav od predka.
Vlastnosť contentEditable opisuje deklaráciu a pri chýbajúcej či neplatnej hodnote vracia inherit; isContentEditable vracia vypočítaný stav v kontexte. Potomok tak môže byť upraviteľný napriek vlastnému neplatnému tokenu.
Vnorený editačný hostiteľ zvyčajne nie je samostatne v poradí tabulátora; ak má byť nezávislým cieľom, pridaj tabindex="0". Úpravy menia DOM, neodosielajú sa automaticky s formulárom a uložené HTML treba čistiť; režim obyčajného textu mení aj vkladanie.
Príklad umiestni contenteditable="invalid" pod upraviteľný rodič: contentEditable vráti inherit, zatiaľ čo isContentEditable vráti true. Ukazuje hranicu medzi deklaráciou a zdedeným stavom.
Prí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ýsledok
parent=true; child=true; raw=inherit
Spustený príklad overuje zdedenú upraviteľnosť potomka s neplatným tokenom a rozlišuje oba pohľady IDL.