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

CKTIS / JavaScript

Element.classList — gerir as classes de um elemento

Element.classList fornece um DOMTokenList dinâmico para ler e alterar classes individuais sem substituir todo o atributo class.

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

element.classList
 element.classList.add(...tokens)
element.classList.remove(...tokens)
element.classList.contains(token)
element.classList.toggle(token, force)
element.classList.replace(token, newToken)

Element.classList devolve o mesmo DOMTokenList dinâmico: as alterações ao atributo class são refletidas nele. Contém tokens únicos por ordem. Se não existirem classes, a lista está vazia.

add(...tokens) adiciona classes sem duplicados, remove(...tokens) remove as classes indicadas e contains(token) verifica se uma classe está presente. Passa argumentos separados, não uma única cadeia com espaços.

toggle(token) alterna a presença; o argumento opcional force força a adição (true) ou a remoção (false). O resultado indica se o token está presente no final. replace(token, newToken) devolve se a substituição ocorreu.

Os métodos que alteram a lista rejeitam um token vazio com SyntaxError e espaços em branco ASCII dentro de um token com InvalidCharacterError — ambos são exceções DOMException. Esta é uma API do DOM, não uma funcionalidade ECMAScript; Node 24 não comprova o suporte nos browsers.

Exemplos

const element = document.createElement('div');
const classes = element.classList;
classes.add('card', 'selected');
classes.add('card');
classes.toggle('selected', false);
classes.replace('card', 'panel');
console.log(element.className);
console.log(classes.contains('selected'));
element.className = 'ready';
console.log(classes.contains('ready'));

Resultado

panel
false
true

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.

Fontes