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

CKTIS / HTML

termo ou valor HTML: class

O atributo `class` atribui tokens usados por seletores, scripts e ferramentas; um nome de classe, por si, não fornece semântica nem estado de acessibilidade.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<p class="note important">…</p>

O valor class é uma lista de tokens separados por espaços. A interface DOMTokenList trata nomes repetidos como um só token, mesmo quando o texto bruto contém inicialmente espaços adicionais ou duplicados.

Usa classList para operações com tokens individuais, pois preserva os limites dos nomes e rejeita um token vazio. className lê ou substitui toda a serialização e pode remover por engano classes pertencentes a outra funcionalidade.

Escolhe nomes para uma função estável do componente ou um estado explícito da aplicação. Não associes o comportamento apenas a classes visuais nem substituas uma propriedade ARIA ou um estado nativo por uma alteração de classe.

O exemplo começa com note note important, executa toggle("important") e add("active") e depois serializa note active. Mostra a remoção e normalização pela interface de tokens.

Exemplos

<!doctype html><meta charset="utf-8"><p id="x" class="note  note important">Text</p><output id="result"></output><script>x.classList.toggle("important");x.classList.add("active");result.textContent=`tokens=${[...x.classList].join(",")}; serialized=${x.className}`;</script>

Resultado

tokens=note,active; serialized=note active

O exemplo executado verifica a deduplicação e alteração da lista sem dividir manualmente o texto do atributo.

Fontes