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

CKTIS / JavaScript

Element: classes, conteúdo e presença de atributos

Usa `className` para ler ou substituir a cadeia de classes, `innerHTML` para ler ou substituir o conteúdo como marcação e `toggleAttribute()` para alterar a presença de um atributo.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)

Estas são API do DOM, não funcionalidades do ECMAScript 2024. A versão do ECMAScript indicada nesta entrada não determina a sua disponibilidade. Exigem um ambiente que disponibilize as API do DOM relevantes; o suporte depende do ambiente de execução.

Num elemento HTML, className reflete o atributo class como uma cadeia de nomes de classes separados por espaços em branco. Uma atribuição substitui toda a cadeia. Para alterar uma classe sem afetar as restantes, usa classList. Num elemento SVG, className pode ser um SVGAnimatedString; usa getAttribute('class') ou setAttribute('class', value) para aceder diretamente ao atributo.

Ao ler innerHTML, obténs a marcação HTML ou XML do conteúdo, sem incluir o próprio elemento nem a sua raiz de sombra. Ao atribuir um valor, a marcação é analisada no contexto do elemento e substitui os nós do conteúdo em vez de acrescentar novos no fim. Num elemento template, é substituído o conteúdo do modelo. Os ouvintes de eventos ficam nos nós antigos e não são transferidos para os novos. Num documento XML, marcação malformada pode provocar SyntaxError na escrita, e uma falha na serialização pode provocar InvalidStateError na leitura.

Não passes marcação não fiável diretamente a innerHTML: por predefinição, não é higienizada, o que cria um risco de XSS. Usa textContent para apresentar texto simples em elementos como span. Não atribuas texto não fiável a textContent de um elemento script: o texto pode ser executado como código quando o elemento for inserido no documento. Se precisares de marcação, higieniza os dados não fiáveis antes de os inserir. Se a CSP exigir Trusted Types e não houver uma política predefinida, atribuir uma cadeia normal lança TypeError; usa TrustedHTML de uma política adequada.

toggleAttribute(name) remove um atributo presente ou adiciona um atributo ausente com um valor vazio. Com force, true garante a presença sem alterar um valor existente e false garante a ausência. O resultado booleano indica se o atributo fica presente após a chamada, não se houve uma alteração. Num atributo booleano HTML como disabled, nem o valor "false" o desativa: o que conta é a presença. Num elemento HTML de um documento HTML, as letras ASCII do nome são convertidas em minúsculas; um nome inválido lança InvalidCharacterError.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element DOM example</title>
</head>
<body>
  <script>
    (() => {
      const button = document.createElement('button');
      button.className = 'action muted';
      button.className = 'action ready';

      button.innerHTML = '<span>Draft</span>';
      const oldLabel = button.firstElementChild;
      button.innerHTML = '<strong>Save</strong>';

      console.log(button.className);
      console.log(button.innerHTML);
      console.log(oldLabel.parentNode === null);
      console.log(button.toggleAttribute('disabled'));
      console.log(button.toggleAttribute('disabled', true));
      console.log(button.toggleAttribute('disabled', false));
    })();
  </script>
</body>
</html>

Resultado

action ready
<strong>Save</strong>
true
true
true
false

Guarda o exemplo como um ficheiro HTML, abre-o num navegador que não exija Trusted Types e consulta a consola de desenvolvimento. O botão não é adicionado ao documento. O primeiro `true` confirma que o nó antigo do rótulo foi separado; os últimos três resultados mostram o estado de `disabled` após a adição, a garantia de presença e a remoção.

Lições relacionadas

  • JavaScript · Lição 39 · Intermédio · Versão: 3

Fontes