CKTIS / JavaScript
Element.replaceChildren() und Element.className
Ersetze oder entferne alle Kindknoten eines Elements und lies oder setze seinen gesamten `class`-Attributwert unabhängig davon.
Version: Current web platform; runtime support varies
Syntax
element.replaceChildren();
element.replaceChildren(node, "text");
element.replaceChildren(...items); // Spread an iterable of nodes and/or strings.
const classes = element.className; // Read the class attribute of an HTML element.
element.className = "panel ready"; // Replace the entire class attribute value.element.replaceChildren(...items) ersetzt alle direkten Kindknoten, einschließlich Textknoten, und gibt undefined zurück. Ein Aufruf kann beliebig viele Node-Objekte und Zeichenketten enthalten. Zeichenketten werden zu Textknoten und nicht als HTML interpretiert. Ohne Argumente leert der Aufruf das Element, ohne es selbst zu entfernen oder seine Attribute zu ändern.
Vorhandene Knoten werden verschoben, nicht geklont. Ein aus dem Baum gelöster Knoten lässt sich wiederverwenden, solange eine Referenz auf ihn erhalten bleibt. Ein Verstoß gegen die Regeln des DOM-Baums, etwa der Versuch, einen Vorfahren als Kind des Elements einzufügen, löst eine DOMException namens HierarchyRequestError aus.
Bei einem HTML-Element spiegelt die Eigenschaft element.className das Attribut class als Zeichenkette mit durch Leerraum getrennten Klassennamen wider. Eine Zuweisung ersetzt den gesamten Wert, ohne die Kindknoten zu ändern. Einzelne Klassen lassen sich mit classList.add(), classList.remove() oder classList.toggle() ändern, ohne die übrigen zu ersetzen. Bei SVG-Elementen kann className ein SVGAnimatedString-Objekt sein; mit getAttribute('class') oder setAttribute('class', value) lässt sich das Attribut selbst lesen oder setzen.
In der Versionsangabe bezeichnet ECMAScript 2024 lediglich die zugrunde gelegte JavaScript-Sprachversion. Dies sind DOM-APIs der Webplattform, keine Funktionen von ECMAScript 2024. Ihre Verfügbarkeit hängt von der Laufzeitumgebung ab; eine Umgebung ohne DOM stellt sie nicht von sich aus bereit.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element.replaceChildren() and Element.className</title>
</head>
<body>
<script>
{
const panel = document.createElement("div");
panel.className = "panel loading";
panel.textContent = "Loading…";
const label = document.createElement("span");
label.textContent = "Ready";
panel.replaceChildren(label, " <pending>");
panel.className = "panel ready";
console.log(`${panel.childNodes.length} | ${panel.textContent} | ${panel.className}`);
panel.replaceChildren();
console.log(`${panel.childNodes.length} | ${panel.className}`);
}
</script>
</body>
</html>Ergebnis
2 | Ready <pending> | panel ready 0 | panel ready
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und sieh in der Browserkonsole nach. Die erste Zeile zeigt zwei Kindknoten: das Element `span` und den wörtlichen Text ` <pending>`. Die zweite zeigt, dass das Attribut `class` nach dem Leeren weiterhin den Wert `panel ready` hat.
Zugehörige Lektionen
- JavaScript · Lektion 43 · Mittlere Stufe · Version: 3