TreeWalker

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.

DasTreeWalker-Objekt repräsentiert die Knoten eines Dokument-Unterbaums und eine Position innerhalb dieser.

EinTreeWalker kann mit der MethodeDocument.createTreeWalker() erstellt werden.

Instanz-Eigenschaften

Diese Schnittstelle erbt keine Eigenschaften.

TreeWalker.rootSchreibgeschützt: Gibt den Wurzel-Node zurück, wie beim Erstellen desTreeWalker spezifiziert.
TreeWalker.whatToShowSchreibgeschützt: Gibt einunsigned long zurück, welches eine Bitmaske aus Konstanten ist, die die Typen vonNode beschreiben, die angezeigt werden müssen. Nicht übereinstimmende Knoten werden übersprungen, aber ihre Kinder können einbezogen werden, falls relevant.
TreeWalker.filterSchreibgeschützt: Gibt denNodeFilter zurück, der mit diesemTreeWalker verbunden ist und verwendet wird, um die relevanten Knoten auszuwählen.
TreeWalker.currentNode: Ist der Knoten, auf den derTreeWalker aktuell zeigt.

Instanz-Methoden

Diese Schnittstelle erbt keine Methoden.

Hinweis:Im Kontext einesTreeWalker ist ein Knotensichtbar, wenn er in der logischen Ansicht existiert, die durch die ArgumentewhatToShow undfilter bestimmt wird. (Ob der Knoten auf dem Bildschirm sichtbar ist, ist irrelevant.)

TreeWalker.parentNode()

Bewegt den aktuellenNode zum erstensichtbaren Vorfahrenknoten in der Dokumentreihenfolge und gibt den gefundenen Knoten zurück. Es bewegt auch den aktuellen Knoten zu diesem Knoten. Wenn ein solcher Knoten nicht existiert oder er vor demWurzelknoten liegt, der bei der Objekterstellung definiert wurde, wirdnull zurückgegeben und der aktuelle Knoten wird nicht geändert.

TreeWalker.firstChild()

Bewegt den aktuellenNode zum erstensichtbaren Kind des aktuellen Knotens und gibt das gefundene Kind zurück. Es bewegt auch den aktuellen Knoten zu diesem Kind. Wenn ein solches Kind nicht existiert, wirdnull zurückgegeben und der aktuelle Knoten wird nicht geändert. Beachten Sie, dass der vonfirstChild() zurückgegebene Knoten vom Wert vonwhatToShow abhängt, der während der Instanziierung desTreeWalker-Objekts festgelegt wurde. Bei Annahme des folgenden HTML-Baums und wenn SiewhatToShow aufNodeFilter.SHOW_ALL setzen, wird ein Aufruf vonfirstChild() einenText-Knoten und nicht einHTMLDivElement-Objekt zurückgeben.

html

<!doctype html><html lang="en">  <head>    <title>Demo</title>  </head>  <body>    <div></div>  </body></html>

let walker = document.createTreeWalker(document.body, NodeFilter.SHOW_ALL);let node = walker.firstChild(); // nodeName: "#text"

Aber wenn wir:

let walker = document.createTreeWalker(  document.body,  NodeFilter.SHOW_ELEMENT,);let node = walker.firstChild(); // nodeName: "DIV"

Das Gleiche gilt fürnextSibling(),previousSibling(),firstChild() undlastChild().

TreeWalker.lastChild()

Bewegt den aktuellenNode zum letztensichtbaren Kind des aktuellen Knotens und gibt das gefundene Kind zurück. Es bewegt auch den aktuellen Knoten zu diesem Kind. Wenn ein solches Kind nicht existiert, wirdnull zurückgegeben und der aktuelle Knoten wird nicht geändert.

TreeWalker.previousSibling()

Bewegt den aktuellenNode zu seinem vorhergehenden Geschwister, falls vorhanden, und gibt das gefundene Geschwister zurück. Wenn es keinen solchen Knoten gibt, wirdnull zurückgegeben und der aktuelle Knoten wird nicht geändert.

TreeWalker.nextSibling()

Bewegt den aktuellenNode zu seinem nächsten Geschwister, falls vorhanden, und gibt das gefundene Geschwister zurück. Wenn es keinen solchen Knoten gibt, wirdnull zurückgegeben und der aktuelle Knoten wird nicht geändert.

TreeWalker.previousNode()

Bewegt den aktuellenNode zum vorhergehendensichtbaren Knoten in der Dokumentreihenfolge und gibt den gefundenen Knoten zurück. Es bewegt auch den aktuellen Knoten zu diesem. Wenn ein solcher Knoten nicht existiert oder er vor demWurzelknoten liegt, der bei der Objekterstellung definiert wurde, wirdnull zurückgegeben und der aktuelle Knoten wird nicht geändert.

TreeWalker.nextNode()

Bewegt den aktuellenNode zum nächstensichtbaren Knoten in der Dokumentreihenfolge und gibt den gefundenen Knoten zurück. Es bewegt auch den aktuellen Knoten zu diesem. Wenn ein solcher Knoten nicht existiert, wirdnull zurückgegeben und der aktuelle Knoten wird nicht geändert.

Spezifikationen

Specification
DOM # interface-treewalker

Browser-Kompatibilität

Siehe auch

Die Erstellermethode:Document.createTreeWalker().
Verwandte Schnittstelle:NodeIterator.

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen •Fehler mit dieser Übersetzung melden