CKTIS / JavaScript
Element.className — Klassen lesen und ersetzen
Bei einem HTML-Element lässt sich der Wert des Attributs `class` über `className` als Zeichenfolge lesen oder durch eine Zeichenfolge ersetzen, nicht als Array von Klassen. `SVGElement.className` ist schreibgeschützt und gibt ein `SVGAnimatedString`-Objekt zurück.
Version: 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 spiegelt das class-Attribut wider. Bei einem HTML-Element gibt das Auslesen den Attributwert als Zeichenfolge zurück; ist das Attribut nicht vorhanden, wird "" zurückgegeben.
Bei einem HTML-Element legt die Zuweisung element.className = "card selected" den gesamten Attributwert fest. Eine weitere Zuweisung ersetzt die bisherigen Klassen, statt eine neue hinzuzufügen. Klassennamen werden durch ASCII-Leerraumzeichen getrennt, nicht durch Kommas. Ein geschütztes Leerzeichen (U+00A0) bleibt Teil eines einzelnen Klassennamens, statt zwei Namen zu trennen.
SVGElement.className ist schreibgeschützt und gibt ein SVGAnimatedString-Objekt zurück, keine Zeichenfolge.
Verwende className, wenn du die gesamte Klassenmenge eines HTML-Elements ersetzen möchtest. Für einzelne Klassen gibt es element.classList, das eine DOMTokenList bereitstellt. Dies ist eine DOM-API und kein Bestandteil der ECMAScript-Sprache.
Beispiele
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);Ergebnis
"" card selected compact
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.