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

CKTIS / JavaScript

DOMTokenList.toggle() — basculer un jeton

DOMTokenList.toggle() bascule la présence d’un jeton ou la force avec force. La méthode indique si le jeton est présent après l’appel.

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

tokenList.toggle(token)
tokenList.toggle(token, force)

DOMTokenList.toggle() agit sur une liste de jetons, comme element.classList. Sans force, la méthode ajoute un token absent ou supprime un jeton présent. Passez un seul jeton, et non plusieurs classes séparées par des espaces.

Avec force défini sur true, la présence du jeton est garantie ; avec false, son absence l’est. Répéter la même opération forcée ne réinverse pas l’état. Le résultat vaut true si le jeton est présent après l’appel, ou false s’il est absent. Il n’indique pas si un changement a eu lieu.

Un jeton vide déclenche une DOMException nommée SyntaxError ; les espaces ASCII dans le jeton provoquent InvalidCharacterError. Il s’agit d’une API DOM, et non d’une fonctionnalité intégrée à ECMAScript. L’exemple nécessite un DOM de navigateur.

Exemples

const element = document.createElement('div');
const tokens = element.classList;
const results = [
  tokens.toggle('active'),
  tokens.toggle('active'),
  tokens.toggle('active', true),
  tokens.toggle('active', true),
  tokens.toggle('active', false)
];
console.log(JSON.stringify(results));
console.log(JSON.stringify(element.className));

Résultat

[true,false,true,true,false]
""

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