CKTIS / JavaScript
Element.innerHTML e Element.className
Usa `innerHTML` para ler ou substituir o conteúdo de um elemento e `className` para ler ou definir as suas classes CSS.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;innerHTML e className são duas propriedades de instância distintas do DOM, não métodos. Fazem parte da plataforma Web, não do ECMAScript 2024: um ambiente de execução JavaScript sem DOM não as disponibiliza.
Ao ler element.innerHTML, obténs uma cadeia de caracteres com a serialização do conteúdo atual, sem as etiquetas do próprio elemento nem as raízes do shadow DOM. Ao atribuir-lhe um valor, o fragmento é analisado como HTML ou XML, consoante o documento, e substitui os nós filhos, não o próprio elemento. Mesmo uma marcação idêntica cria novos nós: as referências antigas continuam a apontar para os nós removidos e os seus recetores de eventos não são transferidos. Num template, a atribuição substitui os nós filhos do DocumentFragment devolvido por content, não o próprio fragmento. Atribuir null equivale a atribuir "". Num documento XML, um fragmento malformado origina SyntaxError e uma falha na serialização pode originar InvalidStateError; ambos são nomes de DOMException.
Nos elementos HTML, element.className reflete o atributo class como uma cadeia de nomes separados por espaços em branco. A atribuição substitui todo o valor do atributo sem alterar os nós filhos. Para alterar apenas uma classe e manter as restantes, usa classList.add(), classList.remove() ou classList.toggle(). Em SVG, className pode ser um SVGAnimatedString; para ler ou escrever todo o atributo, usa antes getAttribute("class") ou setAttribute("class", value). getAttribute() devolve null se o atributo estiver ausente e "" se estiver presente mas vazio.
Por predefinição, innerHTML não higieniza os dados: não lhe atribuas diretamente dados de origem não fiável, pois isso pode permitir ataques de injeção de scripts (XSS). Para inserir texto simples num elemento comum, usa textContent para que o texto não seja interpretado como HTML. Se precisares de marcação de uma fonte não fiável, higieniza-a primeiro. Quando há suporte para Trusted Types, uma política pode devolver conteúdo higienizado como TrustedHTML; o tipo por si só não higieniza. Se a CSP exigir Trusted Types e não houver uma política predefinida, atribuir uma cadeia de caracteres origina TypeError.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML and className</title>
</head>
<body>
<script>
{
const card = document.createElement("div");
card.className = "card muted";
card.innerHTML = "<strong>Ready</strong>";
const original = card.firstElementChild;
card.className = "card active";
card.classList.add("highlight");
console.log(card.className);
console.log(card.firstElementChild === original);
card.innerHTML = "<strong>Ready</strong>";
console.log(card.firstElementChild === original);
console.log(card.innerHTML);
}
</script>
</body>
</html>Resultado
card active highlight true false <strong>Ready</strong>
Guarda o exemplo completo como ficheiro HTML e abre-o no navegador, sem uma CSP que exija Trusted Types. O resultado aparece na consola do navegador. O elemento fica fora do documento. Alterar as classes mantém o nó filho; atribuir HTML idêntico substitui-o.
Lições relacionadas
- JavaScript · Lição 42 · Intermédio · Versão: 3