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.