CKTIS / JavaScript
`className` e `innerHTML`: classes e conteúdo de um elemento
`className` reflete o atributo `class`. `innerHTML` lê a marcação serializada do conteúdo ou interpreta um fragmento para o substituir.
Versão: Current web platform; runtime support varies
Sintaxe
element.className;
htmlElement.className = classString;
element.innerHTML;
element.innerHTML = markup;className e innerHTML são duas propriedades de instância do DOM, não métodos nem funcionalidades da linguagem ECMAScript. São disponibilizadas por um ambiente com DOM, não pelo motor de JavaScript por si só.
Num elemento HTML, className lê o atributo class como uma cadeia de caracteres (vazia se o atributo não existir), e uma atribuição substitui o valor completo do atributo. Para adicionar, remover ou alternar uma classe sem perder as restantes, usa classList.add(), remove() ou toggle(). Em elementos SVG, className pode ser um objeto SVGAnimatedString em vez de uma cadeia de caracteres. Para trabalhar com ambos os tipos de elemento, usa getAttribute("class") e setAttribute("class", value) para ler e escrever o texto do atributo. Quando o atributo não existe, getAttribute() devolve null.
A leitura de innerHTML serializa o conteúdo como HTML ou XML, sem incluir as etiquetas do próprio elemento nem as raízes do Shadow DOM. O resultado não tem de reproduzir o texto original. A atribuição analisa um fragmento no contexto do elemento e substitui os seus nós filhos sem substituir o elemento. Num template, é substituído o conteúdo do modelo. Os nós antigos são desligados; as referências continuam a apontar para eles e os seus listeners de eventos não passam para os novos nós. Num documento XML, um fragmento malformado lança uma DOMException com o nome SyntaxError.
innerHTML não sanitiza a marcação. Os elementos script inseridos não são executados, mas os atributos de tratamento de eventos continuam a poder permitir XSS. Para inserir texto simples num elemento comum, usa textContent. Se precisares de marcação não fiável, sanitiza-a primeiro. Quando uma CSP suportada impõe Trusted Types, atribuir uma cadeia de caracteres sem uma política predefinida lança um TypeError. Em alternativa, podes passar TrustedHTML produzido por uma política que sanitiza os dados de entrada.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>className and innerHTML</title>
<script>
const card = document.createElement("div");
const oldChild = document.createElement("span");
card.append(oldChild);
card.className = "card draft";
card.className = "card ready";
console.log(card.className);
console.log(oldChild.parentNode === card);
card.innerHTML = "<strong>Ready</strong>";
console.log(card.innerHTML);
console.log(oldChild.parentNode === null);
</script>Resultado
card ready true <strong>Ready</strong> true
Guarda o exemplo num ficheiro `.html`, abre-o num navegador e consulta a consola. O primeiro `true` mostra que a alteração das classes preserva o nó filho anterior; o segundo mostra que a atribuição a `innerHTML` o desliga.
Lições relacionadas
- JavaScript · Lição 11 · Avançado · Versão: 4