-
public interface DocumentTraversal
DocumentTraversal
包含创建NodeIterators
和TreeWalkers
以按文档顺序遍历节点及其子节点的方法(深度优先,预订遍历,等效于文档的文本表示中起始标签出现的顺序)。 在支持Traversal功能的DOM中,DocumentTraversal
将由实现Document界面的相同对象实现。另见Document Object Model (DOM) Level 2 Traversal and Range Specification 。
- 从以下版本开始:
- 9,DOM Level 2
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 NodeIterator
createNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)
在指定节点上生成的子NodeIterator
创建一个新的NodeIterator
。TreeWalker
createTreeWalker(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)
在指定节点上生成的子TreeWalker
创建一个新的TreeWalker
。
-
-
-
方法详细信息
-
createNodeIterator
NodeIterator createNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion) throws DOMException
在指定节点上生成的子NodeIterator
创建一个新的NodeIterator
。- 参数
-
root
- 将与其子节点一起迭代的节点。NodeIterator
最初位于该节点之前。 在设置此位置时,不考虑whatToShow
标志和过滤器(如果有)。 根不能是null
。 -
whatToShow
- 此标志指定哪些节点类型可能出现在由NodeIterator
提供的树的逻辑视图中。 请参阅NodeFilter
的可能的SHOW_
值的描述。这些标志可以使用OR
组合。 -
filter
-该NodeFilter
与该使用NodeIterator
,或null
表示没有滤波器。 -
entityReferenceExpansion
- 该标志的值决定是否扩展实体引用节点。 - 结果
-
新创
NodeIterator
。 - 异常
-
DOMException
- NOT_SUPPORTED_ERR:如果指定的root
是null
则null
。
-
createTreeWalker
TreeWalker createTreeWalker(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion) throws DOMException
在指定节点上生成的子TreeWalker
创建一个新的TreeWalker
。- 参数
-
root
- 将作为root
作为root
的TreeWalker
。 设置此值时不考虑whatToShow
标志和NodeFilter
; 任何节点类型将被接受为root
。currentNode
的TreeWalker
初始化为此节点,无论是否可见。root
作为在文档结构中向上看的遍历方法的停止点,如parentNode
和nextNode。root
不能是null
。 -
whatToShow
- 此标志指定哪些节点类型可能出现在由TreeWalker
提供的树的逻辑视图中。 请参阅NodeFilter
的可能的SHOW_
值的描述。这些标志可以使用OR
组合。 -
filter
-该NodeFilter
与该使用TreeWalker
,或null
表示没有滤波器。 -
entityReferenceExpansion
- 如果该标志为false,则EntityReference
节点的内容不会在逻辑视图中显示。 - 结果
-
新创
TreeWalker
。 - 异常
-
DOMException
- NOT_SUPPORTED_ERR:如果指定的root
是null
则null
。
-
-