CKTIS / JavaScript
DOMTokenList — gestire i token con classList
DOMTokenList rappresenta un insieme di token, come le classi di un elemento accessibili tramite classList. Scopri come aggiungere, rimuovere, attivare o disattivare e verificare i token senza elaborare manualmente il testo dell’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
const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);DOMTokenList rappresenta un insieme ordinato di token e distingue tra maiuscole e minuscole. Nel valore dell’attributo, solo i caratteri di spaziatura ASCII separano i token. Ad esempio, uno spazio unificatore (U+00A0) può far parte di un singolo token di classe anziché separare due classi. Un esempio comune è element.classList: un oggetto vivo che riflette l’attributo class. Le modifiche all’elenco aggiornano l’attributo e le modifiche all’attributo sono visibili tramite lo stesso oggetto. Non è un array JavaScript.
DOMTokenList.add, chiamato come tokens.add("card", "active"), aggiunge token singoli e ignora quelli già presenti. DOMTokenList.remove, ad esempio tokens.remove("active", "missing"), rimuove i token indicati; un token mancante non causa errori. Entrambi i metodi accettano più argomenti e restituiscono undefined. Passa le classi separatamente: tokens.add("card", "active"), non tokens.add("card active"). Con add(), un token vuoto causa una DOMException denominata SyntaxError, mentre un token contenente spazi bianchi ASCII causa InvalidCharacterError.
DOMTokenList.contains, usato come tokens.contains("active"), restituisce true o false senza modificare l’elenco. DOMTokenList.toggle, usato come tokens.toggle("selected"), aggiunge un token assente o rimuove un token presente. Il valore restituito indica se il token è presente dopo l’operazione, non se è avvenuta una modifica. La forma tokens.toggle("ready", force) con il valore booleano true garantisce la presenza del token, mentre false ne garantisce l’assenza. Usa questa forma per sincronizzare con uno stato esplicito invece di alternare alla cieca.
Questa è un’API DOM, non una funzionalità di una particolare edizione ECMAScript. MDN indica che l’interfaccia e i quattro metodi qui trattati sono ampiamente disponibili da luglio 2015; per i browser meno recenti, verifica il supporto delle specifiche varianti di chiamata. La presenza di Node 24 in un repository non dimostra il supporto del DOM. L’esempio richiede un browser; l’elemento non deve necessariamente essere collegato al documento.
Esempi
{
const element = document.createElement("div");
const tokens = element.classList;
tokens.add("card", "active", "card");
console.log(tokens.contains("active"));
tokens.remove("active", "missing");
console.log(tokens.toggle("selected"));
console.log(tokens.toggle("selected", false));
tokens.toggle("ready", true);
console.log(element.className);
}Risultato
true true false card ready
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.