Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

termo ou valor HTML: contenteditable

O atributo `contenteditable` ativa ou desativa a edição do conteúdo de um elemento, mas não cria um controlo de formulário nem assegura, por si, armazenamento seguro.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<section contenteditable="true">…</section>

contenteditable é enumerado, não booleano: o valor vazio e true ativam a edição, false desativa-a e plaintext-only limita as operações a texto simples. Um valor ausente ou inválido herda o estado do antepassado.

A propriedade contentEditable apresenta a declaração e devolve inherit para um valor ausente ou inválido; isContentEditable apresenta o estado calculado no contexto. Assim, um descendente pode ser editável apesar do seu próprio token inválido.

Um anfitrião de edição aninhado normalmente não entra em separado na ordem de tabulação; adiciona tabindex="0" se tiver de ser um alvo independente. As alterações modificam o DOM, não são enviadas automaticamente pelo formulário e o HTML guardado precisa de sanitização; o modo de texto também altera a colagem.

O exemplo coloca contenteditable="invalid" sob um elemento editável: contentEditable devolve inherit, enquanto isContentEditable devolve true. Mostra a fronteira entre declaração e estado herdado.

Exemplos

<!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>

Resultado

parent=true; child=true; raw=inherit

O exemplo executado verifica a edição herdada num descendente com token inválido e distingue as duas vistas IDL.

Fontes