CKTIS / JavaScript
Element.replaceChildren() en Element.className
Vervang of verwijder alle onderliggende knopen van een element en lees of wijzig de volledige waarde van het `class`-attribuut zonder die knopen te veranderen.
Versie: 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) vervangt alle directe kindknopen, inclusief tekstknopen, en geeft undefined terug. Eén aanroep accepteert een willekeurig aantal Node-objecten en tekenreeksen. Tekenreeksen worden tekstknopen en worden niet als HTML geïnterpreteerd. Zonder argumenten maakt de aanroep het element leeg zonder het element zelf te verwijderen of zijn attributen te wijzigen.
Bestaande knopen worden verplaatst, niet gekloond. Een losgekoppelde knoop kun je opnieuw gebruiken zolang je er een referentie naar bewaart. Schending van een regel van de DOM-boom, bijvoorbeeld door te proberen een voorouder als kind van het element in te voegen, leidt tot een DOMException met de naam HierarchyRequestError.
Bij een HTML-element weerspiegelt de eigenschap element.className het attribuut class als een tekenreeks met door witruimte gescheiden klassenamen. Een toewijzing vervangt de volledige waarde zonder kindknopen te wijzigen. Wil je afzonderlijke klassen wijzigen zonder de rest te vervangen, gebruik dan classList.add(), classList.remove() of classList.toggle(). Bij SVG-elementen kan className een SVGAnimatedString-object zijn; gebruik getAttribute('class') of setAttribute('class', value) om het attribuut zelf te lezen of te schrijven.
In de versieaanduiding verwijst ECMAScript 2024 alleen naar de JavaScript-taalversie die als uitgangspunt dient. Dit zijn DOM-API’s van het webplatform, geen voorzieningen van ECMAScript 2024. De beschikbaarheid hangt af van de uitvoeromgeving; een omgeving zonder DOM biedt ze niet uit zichzelf aan.
Voorbeelden
<!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>Resultaat
2 | Ready <pending> | panel ready 0 | panel ready
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de browserconsole. De eerste regel toont twee kindknopen: het element `span` en de letterlijke tekst ` <pending>`. De tweede toont dat het attribuut `class` na het legen nog steeds de waarde `panel ready` heeft.
Gerelateerde lessen
- JavaScript · Les 43 · Gemiddeld · Versie: 3