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