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.