大网数据广告活动
Web 标准与前端开发

NodeIterator

· 52CE 我爱测

`NodeIterator`** 接口表示一个遍历 DOM 子树中节点列表的成员的迭代器。节点将按照文档顺序返回。

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 of unsigned long) 显示所有节点。
      NodeFilter.SHOW_ATTRIBUTE 2 显示属性 Attr 节点。只有当用一个 Attr 节点作为根节点来创建 NodeIterator 时才有意义; 在这种情况下,这意味着属性节点会出现在迭代或遍历的首位。因为属性永远不会是其他节点的子节点,当遍历整个文档树时它们不会出现。
      NodeFilter.SHOW_CDATA_SECTION 8 显示CDATASection 节点。
      NodeFilter.SHOW_COMMENT 128 显示Comment 节点。
      NodeFilter.SHOW_DOCUMENT 256 显示Document 节点。
      NodeFilter.SHOW_DOCUMENT_FRAGMENT 1024 显示DocumentFragment节点。
      NodeFilter.SHOW_DOCUMENT_TYPE 512 显示DocumentType 节点。
      NodeFilter.SHOW_ELEMENT 1 显示Element 节点。
      NodeFilter.SHOW_ENTITY 32 显示 Entity 节点。只有当用一个 Entity 节点作为它的根节点来创建一个 NodeIterator 时才有意义; 在这种情况下, Entity 节点会出现在迭代或遍历的首位。因为 Entity 永远不会是其他节点的子节点,当遍历整个文档树时它们不会出现。
      NodeFilter.SHOW_ENTITY_REFERENCE 16 显示EntityReference 节点。
      NodeFilter.SHOW_NOTATION 2048 显示 Notation 节点。只有当用一个 Notation 节点作为它的根节点时来创建一个 NodeIterator 才有意义; 在这种情况下, Notation 节点会出现在迭代或遍历的首位。因为 Notation 永远不会是其他节点的子节点,当遍历整个文档树时它们不会出现。
      NodeFilter.SHOW_PROCESSING_INSTRUCTION 64 显示ProcessingInstruction 节点。
      NodeFilter.SHOW_TEXT 4 显示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 being false, the anchor node.

方法

这个接口不会继承任何属性。

  • NodeIterator.detach()
    • : 这个方法不是必需的。它现在什么也不做。之前用来告诉引擎,NodeIterator 已经不会再使用,现在已经不做任何事情。
  • NodeIterator.previousNode()
    • : 返回前一个 Node,如果不存在则返回 null.
  • NodeIterator.nextNode()
    • : 返回下一个 Node, 如果不存在则返回null .

规范

浏览器兼容性

参见

  • The creator method: Document.createNodeIterator().
  • Related interfaces: NodeFilter, TreeWalker.

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。