CKTIS / JavaScript
Element.className — ler e substituir classes
Num elemento HTML, `className` permite ler ou substituir o valor do atributo `class`. Esse valor é uma cadeia de caracteres, não um array de classes. `SVGElement.className` é uma propriedade só de leitura que devolve um objeto `SVGAnimatedString`.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
// For an HTML element:
element.className
element.className = "class1 class2";Element.className reflete o atributo class. Num elemento HTML, a leitura devolve o valor do atributo como uma cadeia de caracteres; se o atributo não existir, devolve "".
Num elemento HTML, a atribuição element.className = "card selected" define o valor completo do atributo. Uma atribuição posterior substitui as classes anteriores, em vez de acrescentar uma nova. Separe os nomes das classes com caracteres de espaço em branco ASCII, não com vírgulas. Um espaço inquebrável (U+00A0) faz parte de um único nome de classe, em vez de separar dois nomes.
SVGElement.className é uma propriedade só de leitura que devolve um objeto SVGAnimatedString, não uma cadeia de caracteres.
Utilize className quando quiser substituir o conjunto completo de classes de um elemento HTML. Para operar sobre classes individuais, utilize element.classList, que disponibiliza um DOMTokenList. Esta é uma API do DOM, não uma funcionalidade da linguagem ECMAScript.
Exemplos
const element = document.createElement("div");
console.log(JSON.stringify(element.className));
element.className = "card selected";
console.log(element.getAttribute("class"));
element.className = "compact";
console.log(element.className);Resultado
"" card selected compact
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.