NodeIterator
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
L'interface NodeIterator représente un itérateur pour les membres d'une liste des nœuds dans un sous-arbre du DOM. Les nœuds seront renvoyés dans l'ordre du document.
Un NodeIterator peut être créé en utilisant la méthode Document.createNodeIterator(), comme suit :
var nodeIterator = document.createNodeIterator(root, whatToShow, filter);
Propriétés
L'interface n'hérite d'aucune propriété.
NodeIterator.rootLecture seule-
Renvoie un
Node(noeud) représentant le noeud racine comme spécifié lors de la création duNodeIterator. NodeIterator.whatToShowLecture seule-
Renvoie un
unsigned long(long non signé), celui-ci étant un masque constitué de constantes décrivant les types deNode(noeud) et devant être présenté. Les nœuds non correspondants sont ignorés, mais leurs enfants peuvent être inclus, le cas échéant. Les valeurs possibles sont :Constante Valeur numérique Description NodeFilter.SHOW_ALL-1(c'est la valeur numérique maximale duunsigned long(non signé long))Affiche tous les noeuds. NodeFilter.SHOW_ATTRIBUTEObsolète2Affiche l'attribut Attrdes noeuds. Cela n'a de sens que lors de la création d'unTreeWalkeravec un noeudAttrcomme racine ; dans ce cas, cela signifie que le nœud d'attribut apparaîtra dans la première position de l'itération ou de la traversée. Comme les attributs ne sont jamais des enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de l'arbre du document.NodeFilter.SHOW_CDATA_SECTIONObsolète8Affiche les noeuds CDATASection.NodeFilter.SHOW_COMMENT128Affiche les noeuds Comment.NodeFilter.SHOW_DOCUMENT256Affiche les noeuds Document.NodeFilter.SHOW_DOCUMENT_FRAGMENT1024Affiche les noeuds DocumentFragment.NodeFilter.SHOW_DOCUMENT_TYPE512Affiche les noeuds DocumentType.NodeFilter.SHOW_ELEMENT1Affiche les noeuds Element.NodeFilter.SHOW_ENTITYObsolète32Affiche les noeuds Entity. Cela n'a de sens que lors de la création d'unTreeWalkeravec un noeudEntitycomme racine ; dans ce cas, il signifie que le noeud d'entitéEntityapparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.NodeFilter.SHOW_ENTITY_REFERENCEObsolète16Affiche les noeuds EntityReference.NodeFilter.SHOW_NOTATIONObsolète2048Affiche les noeuds Notation. Cela n'a de sens que lors de la création d'unTreeWalkeravec un noeudNotationcomme racine ; dans ce cas, il signifie que le noeudNotationapparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.NodeFilter.SHOW_PROCESSING_INSTRUCTION64Affiche les noeuds ProcessingInstruction.NodeFilter.SHOW_TEXT4Affiche les noeuds Text. NodeIterator.filterLecture seule-
Renvoie un
NodeFilterutilisé pour sélectionner les noeuds pertinents. NodeIterator.expandEntityReferencesLecture seule Obsolète-
est un
Boolean(booléen) indiquant si, lors de la suppression d'uneEntityReference, tout son sous-arbre doit être supprimé en même temps. NodeIterator.referenceNodeLecture seule Expérimental-
Renvoie le
Node(noeud) auquel l'itérateur est ancré. NodeIterator.pointerBeforeReferenceNodeLecture seule Expérimental-
Renvoie un
Boolean(booléen) qui indique si leNodeIteratorest ancré avant (true(vrai)) ou après (false(faux)) le noeud d'ancrage.
Méthodes
Cette interface n'hérite d'aucune méthode.
NodeIterator.detach()Obsolète-
Cette opération est une non opération. Elle ne fait rien. Auparavant, elle disait au moteur que le
NodeIteratorn'était plus utilisé, mais c'est maintenant inutile. NodeIterator.previousNode()-
Renvoie le noeud
Nodeprécédent dans le document ounulls'il n'y en a aucun. NodeIterator.nextNode()-
Renvoie le noeud
Nodesuivant dans le document ounulls'il n'y en a aucun.
Spécifications
| Specification |
|---|
| DOM> # interface-nodeiterator> |
Compatibilité des navigateurs
Chargement…
Voir aussi
- La méthode de création :
Document.createNodeIterator(). - Interfaces connexes :
NodeFilter,TreeWalker.