WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen