Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła