CKTIS / JavaScript
DOMTokenList: verificare e alternare la presenza dei token
`contains()` verifica la presenza di un token senza modificare l’elenco. `toggle()` ne inverte o ne imposta la presenza con `force`, poi indica se il token è presente.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
tokens.contains(token)
tokens.toggle(token)
tokens.toggle(token, force)element.classList restituisce una DOMTokenList che riflette in ogni momento l’attributo class dell’elemento. Questi metodi fanno parte dell’API DOM, non di ECMAScript 2024. Il supporto dipende dall’ambiente di esecuzione. Nel browser l’esempio usa il DOM nativo, mentre in Node.js usa un’implementazione semplificata per i token validi mostrati.
tokens.contains(token) restituisce true se il token esatto è presente, altrimenti false. Non modifica l’elenco, distingue tra maiuscole e minuscole e non cerca sottostringhe. Restituisce false per una stringa vuota o contenente uno spazio bianco ASCII.
tokens.toggle(token) aggiunge un token assente o rimuove un token presente. tokens.toggle(token, true) ne garantisce la presenza; tokens.toggle(token, false) ne garantisce l’assenza. Il risultato indica se il token è presente dopo la chiamata, non se l’elenco è cambiato. Per legare la presenza di una classe a una condizione booleana, usa tokens.toggle(token, condition). Passare undefined come force equivale a omettere l’argomento: tokens.toggle(token, undefined) aggiunge il token se manca e lo rimuove se è presente. Qualsiasi altro valore passato come force viene convertito in booleano: la stringa "false" diventa true, non false.
toggle() accetta un solo token alla volta. Una stringa vuota genera una DOMException di nome SyntaxError; uno spazio bianco ASCII nel token genera una DOMException di nome InvalidCharacterError, anche se force vale false. Passa il nome della classe senza il punto del selettore: "active", non ".active".
Esempi
{
function createExampleElement(initialClass) {
if (typeof document !== "undefined") {
const element = document.createElement("div");
element.className = initialClass;
return element;
}
// Node.js has no browser DOM. This stand-in handles the valid tokens used below.
const classes = new Set([initialClass]);
return {
get className() {
return [...classes].join(" ");
},
classList: {
contains(token) {
return classes.has(token);
},
toggle(token, force) {
const present = force === undefined ? !classes.has(token) : Boolean(force);
if (present) classes.add(token);
else classes.delete(token);
return present;
},
},
};
}
const element = createExampleElement("panel");
const tokens = element.classList;
console.log(tokens.contains("active"));
console.log(tokens.toggle("active"));
console.log(tokens.toggle("active"));
console.log(tokens.toggle("active", true));
console.log(tokens.toggle("active", true));
console.log(tokens.toggle("active", false));
console.log(element.className);
}Risultato
false true false true true false panel
Le due chiamate senza `force` aggiungono e poi rimuovono `active`. Entrambe le chiamate con `true` restituiscono `true`, anche se la seconda non cambia nulla. La chiamata con `false` rimuove `active`, lasciando solo `panel`.
Lezioni correlate
- JavaScript · Lezione 31 · Intermedio · Versione: 3