CKTIS / HTML
termin lub wartość HTML: contenteditable
Atrybut `contenteditable` włącza edycję zawartości elementu albo ją wyłącza, ale nie tworzy kontrolki formularza i nie zapewnia samodzielnie bezpiecznego zapisu zmian.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<section contenteditable="true">…</section>contenteditable jest atrybutem wyliczeniowym, nie logicznym: pusty zapis i true włączają edycję, false ją wyłącza, a plaintext-only ogranicza operacje do zwykłego tekstu. Brak lub niepoprawna wartość dziedziczy stan od przodka.
Właściwość contentEditable pokazuje deklarację i zwraca inherit dla braku albo niepoprawnej wartości; isContentEditable podaje obliczony stan elementu w jego kontekście. Dzięki temu potomek może być edytowalny mimo niepoprawnego własnego tokenu.
Zagnieżdżony obszar edycji zwykle nie wchodzi osobno do kolejności klawiaturowej; jeśli ma być niezależnym celem, potrzebuje tabindex="0". Zmiany modyfikują DOM, nie są automatycznie wysyłane z formularzem, a HTML zapisywany na serwerze trzeba sanitować; tryb tekstowy ma inne zasady wklejania.
Przykład umieszcza contenteditable="invalid" pod edytowalnym rodzicem: contentEditable zwraca inherit, natomiast isContentEditable zwraca true. To pokazuje granicę między surową deklaracją a stanem dziedziczonym.
Przykłady
<!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>Wynik
parent=true; child=true; raw=inherit
Wykonany przykład potwierdza dziedziczenie edytowalności przez potomka z niepoprawnym tokenem i rozróżnia oba interfejsy IDL.