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

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

Fontes