CKTIS / JavaScript
DOMTokenList : vérifier et basculer des jetons
`contains()` vérifie la présence d’un jeton sans modifier la liste. `toggle()` inverse ou impose sa présence avec `force`, puis indique si le jeton est présent après l’appel.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
tokens.contains(token)
tokens.toggle(token)
tokens.toggle(token, force)element.classList fournit une DOMTokenList qui reflète en temps réel l’attribut class de l’élément. Ces méthodes relèvent de l’API DOM, pas d’ECMAScript 2024. Leur prise en charge dépend de l’environnement d’exécution. Dans un navigateur, l’exemple utilise le DOM natif ; dans Node.js, il utilise une implémentation simplifiée pour les jetons valides de l’exemple.
tokens.contains(token) renvoie true si le jeton exact est présent, sinon false. La méthode ne modifie pas la liste, respecte la casse et ne recherche pas de sous-chaîne. Elle renvoie false pour une chaîne vide ou contenant un caractère d’espacement ASCII.
tokens.toggle(token) ajoute un jeton absent ou retire un jeton présent. tokens.toggle(token, true) garantit sa présence ; tokens.toggle(token, false) garantit son absence. La valeur renvoyée indique si le jeton est présent après l’appel, non si la liste a changé. Pour faire dépendre une classe d’une condition booléenne, utilisez tokens.toggle(token, condition). Passer undefined pour force revient à omettre l’argument : tokens.toggle(token, undefined) inverse l’état de présence du jeton. Toute autre valeur fournie pour force est convertie en booléen : la chaîne "false" devient true, et non false.
toggle() traite un seul jeton à la fois. Une chaîne vide déclenche une DOMException nommée SyntaxError ; un caractère d’espacement ASCII dans le jeton déclenche une DOMException nommée InvalidCharacterError, même si force vaut false. Passez le nom de classe sans le point du sélecteur : "active", pas ".active".
Exemples
{
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);
}Résultat
false true false true true false panel
Les deux appels sans `force` ajoutent puis retirent `active`. Les deux appels avec `true` renvoient `true`, même si le second ne change rien. L’appel avec `false` retire `active` : il ne reste que `panel`.
Leçons associées
- JavaScript · Leçon 31 · Intermédiaire · Version : 3