CKTIS / JavaScript
Element.className — klassen lezen en vervangen
Bij een HTML-element kun je met `className` de waarde van het `class`-attribuut uitlezen of vervangen. Die waarde is een tekenreeks, geen array met klassen. `SVGElement.className` is alleen-lezen en geeft een `SVGAnimatedString`-object terug.
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
// For an HTML element:
element.className
element.className = "class1 class2";Element.className weerspiegelt het class-attribuut. Bij een HTML-element levert het uitlezen de attribuutwaarde op als tekenreeks; als het attribuut ontbreekt, wordt "" teruggegeven.
Bij een HTML-element stel je met de toewijzing element.className = "card selected" de volledige attribuutwaarde in. Een volgende toewijzing vervangt de eerdere klassen in plaats van er een toe te voegen. Scheid klassennamen met ASCII-witruimte, niet met komma’s. Een vaste spatie (U+00A0) blijft onderdeel van één klassenaam en scheidt dus geen twee namen.
SVGElement.className is alleen-lezen en geeft een SVGAnimatedString-object terug, geen tekenreeks.
Gebruik className als je de volledige set klassen van een HTML-element wilt vervangen. Voor bewerkingen op afzonderlijke klassen gebruik je element.classList, dat een DOMTokenList beschikbaar stelt. Dit is een DOM-API, geen functie van de ECMAScript-taal.
Voorbeelden
const element = document.createElement("div");
console.log(JSON.stringify(element.className));
element.className = "card selected";
console.log(element.getAttribute("class"));
element.className = "compact";
console.log(element.className);Resultaat
"" card selected compact
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.