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.