Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources