CKTIS / JavaScript
DOM-Navigation: Kindelemente, Tagname, Elternelement und Geschwister
Lies den Tagnamen aus und navigiere zu direkten Kindelementen, zum Elternelement und zu benachbarten Elementen. Lerne, wann eine Sammlung aktuell bleibt und wann eine Eigenschaft `null` liefern kann.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.children // HTMLCollection
element.tagName // string
element.parentElement // Element or null
element.previousElementSibling // Element or null
element.nextElementSibling // Element or nullDiese fünf DOM-Eigenschaften sind schreibgeschützt. Lies sie mit der Punktnotation ohne Aufrufklammern. Sie gehören zur DOM-API, nicht zu ECMAScript 2024; eine Laufzeitumgebung ohne DOM stellt sie nicht bereit.
element.children ist eine Live-HTMLCollection der direkten Kindelemente in DOM-Reihenfolge. Ohne Kindelemente ist sie leer. element.childNodes ist ebenfalls live, aber eine NodeList aller direkten Kindknoten, einschließlich Text und Kommentaren. Eine gespeicherte children-Sammlung aktualisiert sich bei DOM-Änderungen. Array.from(element.children) hält die aktuellen Elementreferenzen und ihre Reihenfolge in einem Array fest, ohne die Elemente zu klonen.
element.tagName liefert den qualifizierten Tagnamen als Zeichenkette, gegebenenfalls mit Präfix. Bei einem Element im HTML-Namensraum in einem HTML-Dokument werden ASCII-Buchstaben großgeschrieben, wie in "DIV". Andernfalls bleibt die Schreibweise erhalten, auch bei SVG in einem HTML-Dokument und bei als XML verarbeitetem XHTML. Verwende für namensraumbewusste Vergleiche localName zusammen mit namespaceURI.
element.parentElement stammt von Node. Die Eigenschaft liefert den direkten Elternknoten, wenn er ein Element ist, sonst null – auch wenn es keinen Elternknoten gibt. Beim Wurzelelement eines Dokuments ist parentElement beispielsweise null, während parentNode das Document liefert.
previousElementSibling und nextElementSibling liefern das nächstgelegene Element vor bzw. nach dem aktuellen Element unter demselben Elternknoten, oder null, wenn es keines gibt. Sie überspringen Text und Kommentare, anders als previousSibling und nextSibling, die solche Knoten liefern können. Prüfe vor dem Lesen von tagName auf null oder nutze element.nextElementSibling?.tagName; ohne nächstes Geschwisterelement ergibt das undefined.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM element traversal</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument();
const box = doc.createElement('div');
const first = doc.createElement('span');
const second = doc.createElement('em');
box.append(first, ' ', doc.createComment('gap'), second);
const live = box.children;
const snapshot = Array.from(live);
console.log(JSON.stringify([live.length, box.childNodes.length, live[0].tagName]));
console.log(JSON.stringify([
first.parentElement?.tagName,
first.nextElementSibling?.tagName,
second.previousElementSibling?.tagName,
first.previousElementSibling,
second.nextElementSibling
]));
box.append(doc.createElement('strong'));
console.log(JSON.stringify([
live.length, snapshot.length,
doc.documentElement.parentElement,
doc.documentElement.parentNode === doc
]));
}
</script>
</body>
</html>Ergebnis
[2,4,"SPAN"] ["DIV","EM","SPAN",null,null] [3,2,null,true]
Speichere das Beispiel als `.html`-Datei, öffne sie im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Das Beispiel verwendet ein separates HTML-Dokument und ändert die geöffnete Seite nicht. Leerzeichen und Kommentar zählen in `childNodes`, nicht aber in `children`. Beim Anhängen eines Elements wächst nur die Länge der Live-Sammlung.
Zugehörige Lektionen
- JavaScript · Lektion 34 · Mittlere Stufe · Version: 3
Quellen
- Element: children property
- Element: tagName property
- Node: parentElement property
- Element: previousElementSibling property
- Element: nextElementSibling property
- Node: childNodes property
- HTMLCollection
- Element: localName property
- Element: namespaceURI property
- DOMImplementation: createHTMLDocument() method
- HTML Standard: Terminology
- ECMAScript 2024 Language Specification: Optional Chains