DOM
NodeIterator 接口表示一个遍历 DOM 子树中节点列表的成员的迭代器。节点将按照文档顺序返回。
NodeIterator 可以使用 Document.createNodeIterator() 方法创建,如下所示:
var nodeIterator = document.createNodeIterator(root, whatToShow, filter);
属性
这个接口不继承任何属性。
-
NodeIterator.root
- : 返回一个 Node,它代表创建 NodeIterator 时指定的根节点。
-
NodeIterator.whatToShow
-
: 返回一个无符号长整型,它是一个由描述必须呈现的 Node 类型的常量构成的位掩码。不匹配的节点被跳过,但是如果相关,他们的子节点可能被包括在内。可能的值是:
Constant Numerical value Description NodeFilter.SHOW_ALL-1(that is the max value ofunsigned long)显示所有节点。 NodeFilter.SHOW_ATTRIBUTE2显示属性 Attr 节点。只有当用一个 Attr 节点作为根节点来创建 NodeIterator 时才有意义; 在这种情况下,这意味着属性节点会出现在迭代或遍历的首位。因为属性永远不会是其他节点的子节点,当遍历整个文档树时它们不会出现。 NodeFilter.SHOW_CDATA_SECTION8显示CDATASection 节点。 NodeFilter.SHOW_COMMENT128显示Comment 节点。 NodeFilter.SHOW_DOCUMENT256显示Document 节点。 NodeFilter.SHOW_DOCUMENT_FRAGMENT1024显示DocumentFragment节点。 NodeFilter.SHOW_DOCUMENT_TYPE512显示DocumentType 节点。 NodeFilter.SHOW_ELEMENT1显示Element 节点。 NodeFilter.SHOW_ENTITY32显示 Entity 节点。只有当用一个 Entity 节点作为它的根节点来创建一个 NodeIterator 时才有意义; 在这种情况下, Entity 节点会出现在迭代或遍历的首位。因为 Entity 永远不会是其他节点的子节点,当遍历整个文档树时它们不会出现。 NodeFilter.SHOW_ENTITY_REFERENCE16显示EntityReference 节点。 NodeFilter.SHOW_NOTATION2048显示 Notation 节点。只有当用一个 Notation 节点作为它的根节点时来创建一个 NodeIterator 才有意义; 在这种情况下, Notation 节点会出现在迭代或遍历的首位。因为 Notation 永远不会是其他节点的子节点,当遍历整个文档树时它们不会出现。 NodeFilter.SHOW_PROCESSING_INSTRUCTION64显示ProcessingInstruction 节点。 NodeFilter.SHOW_TEXT4显示Text 节点。
-
-
NodeIterator.filter
- : 返回一个用来选择相关节点的 NodeFilter .
-
NodeIterator.expandEntityReferences
- : Is a Boolean indicating if, when discarding an EntityReference its whole sub-tree must be discarded at the same time.
-
NodeIterator.referenceNode
- : 返回当前遍历到的 Node .
-
NodeIterator.pointerBeforeReferenceNode
- : Returns a Boolean flag that indicates whether the NodeIterator is anchored before, the flag being
true, or after, the flag beingfalse, the anchor node.
- : Returns a Boolean flag that indicates whether the NodeIterator is anchored before, the flag being
方法
这个接口不会继承任何属性。
- NodeIterator.detach()
- : 这个方法不是必需的。它现在什么也不做。之前用来告诉引擎,
NodeIterator已经不会再使用,现在已经不做任何事情。
- : 这个方法不是必需的。它现在什么也不做。之前用来告诉引擎,
- NodeIterator.previousNode()
- : 返回前一个 Node,如果不存在则返回
null.
- : 返回前一个 Node,如果不存在则返回
- NodeIterator.nextNode()
- : 返回下一个 Node, 如果不存在则返回
null.
- : 返回下一个 Node, 如果不存在则返回
规范
浏览器兼容性
参见
- The creator method: Document.createNodeIterator().
- Related interfaces: NodeFilter, TreeWalker.
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
