NodeIterator
Die NodeIterator
-Schnittstelle repräsentiert einen Iterator, um Knoten eines DOM-Teilbaums in Dokumentenreihenfolge zu durchlaufen.
Syntax
Ein NodeIterator
kann mit der Methode Document.createNodeIterator()
erstellt werden, wie folgt:
const nodeIterator = document.createNodeIterator(root, whatToShow, filter);
Instanz-Eigenschaften
Diese Schnittstelle erbt keine Eigenschaften.
NodeIterator.root
Nur lesbar-
Gibt ein
Node
zurück, das den Wurzelknoten darstellt, wie beim Erstellen desNodeIterator
festgelegt wurde. NodeIterator.whatToShow
Nur lesbar-
Gibt ein
unsigned long
Bitmaske zurück, die die Typen vonNode
beschreibt, die übereinstimmen sollen. Nicht übereinstimmende Knoten werden übersprungen, aber relevante Kindknoten können enthalten sein.Die möglichen Bitmaskenwerte sind Konstanten aus der
NodeFilter
-Schnittstelle:Konstante Zahlenwert Beschreibung NodeFilter.SHOW_ALL
4294967295
(das ist der Maximalwert vonunsigned long
)Zeigt alle Knoten. NodeFilter.SHOW_ATTRIBUTE
Veraltet2
Zeigt Attribut- Attr
-Knoten. Dies ist nur sinnvoll, wenn einNodeIterator
mit einemAttr
-Knoten als seine Wurzel erstellt wird; in diesem Fall bedeutet es, dass der Attributknoten in der ersten Position der Iteration oder des Durchlaufs erscheint. Da Attribute niemals Kinder anderer Knoten sind, erscheinen sie nicht beim Durchlaufen des Dokumentbaums.NodeFilter.SHOW_CDATA_SECTION
Veraltet8
Zeigt CDATASection
-Knoten.NodeFilter.SHOW_COMMENT
128
Zeigt Comment
-Knoten.NodeFilter.SHOW_DOCUMENT
256
Zeigt Document
-Knoten.NodeFilter.SHOW_DOCUMENT_FRAGMENT
1024
Zeigt DocumentFragment
-Knoten.NodeFilter.SHOW_DOCUMENT_TYPE
512
Zeigt DocumentType
-Knoten.NodeFilter.SHOW_ELEMENT
1
Zeigt Element
-Knoten.NodeFilter.SHOW_ENTITY
Veraltet32
Veraltet, wird nicht mehr verwendet. NodeFilter.SHOW_ENTITY_REFERENCE
Veraltet16
Veraltet, wird nicht mehr verwendet. NodeFilter.SHOW_NOTATION
Veraltet2048
Veraltet, wird nicht mehr verwendet. NodeFilter.SHOW_PROCESSING_INSTRUCTION
64
Zeigt ProcessingInstruction
-Knoten.NodeFilter.SHOW_TEXT
4
Zeigt Text
-Knoten. NodeIterator.filter
Nur lesbar-
Gibt ein
NodeFilter
zurück, das verwendet wird, um die relevanten Knoten auszuwählen. -
NodeIterator.referenceNode
Nur lesbar Experimentell -
Gibt den
Node
zurück, an den der Iterator verankert ist. NodeIterator.pointerBeforeReferenceNode
Nur lesbar-
Gibt ein Boolean zurück, das angibt, ob der
NodeIterator
vor demNodeIterator.referenceNode
verankert ist. Wennfalse
, bedeutet das, dass der Iterator nach dem Referenzknoten verankert ist.
Instanz-Methoden
Diese Schnittstelle erbt keine Methoden.
NodeIterator.detach()
Veraltet-
Dies ist eine veraltete Methode und hat keine Wirkung mehr. Früher diente sie dazu, einen
NodeIterator
als entsorgt zu markieren, sodass er durch die Speicherbereinigung wieder freigegeben werden konnte. NodeIterator.previousNode()
-
Gibt den vorherigen
Node
im Dokument zurück odernull
, wenn es keinen gibt. NodeIterator.nextNode()
-
Gibt den nächsten
Node
im Dokument zurück odernull
, wenn es keinen gibt.
Spezifikationen
Specification |
---|
DOM Standard # interface-nodeiterator |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Die Erstellermethode:
Document.createNodeIterator()
. - Verwandte Schnittstelle:
TreeWalker