CKTIS / JavaScript
Element.classList — gérer les classes d’un élément
Element.classList fournit une DOMTokenList vivante pour lire et modifier des classes individuelles sans remplacer l’intégralité 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
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 renvoie la même DOMTokenList vivante : les modifications de l’attribut class y sont répercutées. Elle contient des jetons uniques, dans l’ordre. En l’absence de classes, la liste est vide.
add(...tokens) ajoute des classes sans doublons, remove(...tokens) supprime les classes indiquées et contains(token) vérifie la présence d’une classe. Passez des arguments séparés, et non une seule chaîne contenant des espaces.
toggle(token) inverse la présence du jeton ; l’argument facultatif force impose son ajout (true) ou sa suppression (false). Le résultat indique sa présence finale. replace(token, newToken) renvoie un booléen indiquant si le remplacement a eu lieu.
Les méthodes qui modifient la liste rejettent un jeton vide avec SyntaxError et les espaces ASCII dans un jeton avec InvalidCharacterError — les deux sont des exceptions DOMException. Il s’agit d’une API DOM, pas d’une fonctionnalité ECMAScript ; Node 24 ne prouve pas sa prise en charge par les navigateurs.
Exemples
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'));Résultat
panel false true
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.