CKTIS / JavaScript
Element.classList — de klassen van een element beheren
Element.classList biedt een live DOMTokenList om afzonderlijke klassen te lezen en te wijzigen zonder het volledige class-attribuut te vervangen.
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
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 geeft dezelfde live DOMTokenList terug: wijzigingen aan het class-attribuut worden erin weergegeven. De lijst bevat unieke tokens in volgorde. Zonder klassen is de lijst leeg.
add(...tokens) voegt klassen toe zonder duplicaten, remove(...tokens) verwijdert opgegeven klassen en contains(token) controleert of een klasse aanwezig is. Geef afzonderlijke argumenten door, geen enkele tekenreeks met spaties.
toggle(token) wisselt de aanwezigheid om; het optionele force dwingt toevoegen (true) of verwijderen (false) af. Het resultaat geeft aan of het token uiteindelijk aanwezig is. replace(token, newToken) geeft terug of de vervanging heeft plaatsgevonden.
Methoden die wijzigingen aanbrengen, weigeren een leeg token met SyntaxError en ASCII-witruimte binnen een token met InvalidCharacterError — beide zijn DOMException-uitzonderingen. Dit is een DOM-API, geen ECMAScript-functie; Node 24 bewijst geen browserondersteuning.
Voorbeelden
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'));Resultaat
panel false true
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.