CKTIS / JavaScript
DOMTokenList — gérer les jetons avec classList
DOMTokenList représente un ensemble de jetons, comme les classes d’un élément accessibles via classList. Apprenez à ajouter, supprimer, basculer et vérifier des jetons sans traiter manuellement le texte de l’attribut class.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);DOMTokenList représente un ensemble ordonné de jetons et distingue les majuscules des minuscules. Dans la valeur de l’attribut, seuls les caractères d’espacement ASCII séparent les jetons. Par exemple, une espace insécable (U+00A0) peut faire partie d’un seul jeton de classe au lieu de séparer deux classes. Un exemple courant est element.classList : un objet vivant qui reflète l’attribut class. Les modifications de la liste mettent à jour l’attribut, et les modifications de l’attribut sont visibles par le même objet. Ce n’est pas un tableau JavaScript.
DOMTokenList.add, appelé sous la forme tokens.add("card", "active"), ajoute des jetons individuels et ignore ceux déjà présents. DOMTokenList.remove, par exemple tokens.remove("active", "missing"), supprime les jetons indiqués ; l’absence d’un jeton ne provoque pas d’erreur. Les deux méthodes acceptent plusieurs arguments et renvoient undefined. Passez les classes séparément : tokens.add("card", "active"), et non tokens.add("card active"). Pour add(), un jeton vide provoque une DOMException nommée SyntaxError, tandis qu’un jeton contenant un espace blanc ASCII provoque InvalidCharacterError.
DOMTokenList.contains, utilisé sous la forme tokens.contains("active"), renvoie true ou false sans modifier la liste. DOMTokenList.toggle, utilisé sous la forme tokens.toggle("selected"), ajoute un jeton absent ou supprime un jeton présent. Sa valeur de retour indique si le jeton est présent après l’opération, et non si une modification a eu lieu. La forme tokens.toggle("ready", force) avec la valeur booléenne true garantit la présence du jeton, tandis que false garantit son absence. Utilisez cette forme pour synchroniser avec un état explicite plutôt que de basculer sans condition.
Il s’agit d’une API DOM, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique que l’interface et les quatre méthodes présentées ici sont largement disponibles depuis juillet 2015 ; vérifiez la prise en charge des variantes d’appel spécifiques pour les anciens navigateurs. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge du DOM. L’exemple nécessite un navigateur ; l’élément n’a pas besoin d’être rattaché au document.
Exemples
{
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);
}Résultat
true true false card ready
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.