Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti