KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOMTokenList.toggle() — een token omschakelen

DOMTokenList.toggle() schakelt de aanwezigheid van een token om of dwingt die af met force. De methode geeft aan of het token na de aanroep aanwezig is.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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

DOMTokenList.toggle() werkt op een tokenlijst, zoals element.classList. Zonder force voegt de methode een afwezig token toe of verwijdert ze een aanwezig token. Geef één token door, niet meerdere door spaties gescheiden klassen.

Met force ingesteld op true wordt de aanwezigheid van het token afgedwongen; met false de afwezigheid. Dezelfde geforceerde bewerking herhalen draait de toestand niet terug. Het resultaat is true als het token na de aanroep aanwezig is, of false als het afwezig is. Het geeft niet aan of er iets is veranderd.

Een leeg token veroorzaakt een DOMException met de naam SyntaxError; ASCII-witruimte in het token veroorzaakt InvalidCharacterError. Dit is een DOM-API, geen ingebouwde functie van ECMAScript. Het voorbeeld vereist een browser-DOM.

Voorbeelden

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));

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen