CKTIS / JavaScript
Element.classList — gestire le classi di un elemento
Element.classList fornisce un DOMTokenList dinamico per leggere e modificare singole classi senza sostituire l’intero attributo class.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
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 restituisce lo stesso DOMTokenList dinamico: le modifiche all’attributo class si riflettono nell’elenco. Contiene token univoci in ordine. Se non ci sono classi, l’elenco è vuoto.
add(...tokens) aggiunge classi senza duplicati, remove(...tokens) rimuove le classi indicate e contains(token) verifica la presenza di una classe. Passa argomenti separati, non un’unica stringa contenente spazi.
toggle(token) alterna la presenza; l’argomento facoltativo force impone l’aggiunta (true) o la rimozione (false). Il risultato indica la presenza finale. replace(token, newToken) restituisce se la sostituzione è avvenuta.
I metodi che modificano l’elenco rifiutano un token vuoto con SyntaxError e gli spazi ASCII all’interno di un token con InvalidCharacterError: entrambe sono eccezioni DOMException. Questa è un’API DOM, non una funzionalità ECMAScript; Node 24 non dimostra il supporto nei browser.
Esempi
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'));Risultato
panel false true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.