-
public interface DocumentTraversal
DocumentTraversal
包含创建NodeIterators
和TreeWalkers
以按文档顺序遍历节点及其子节点的方法(深度优先,预先遍序遍历,这相当于文档的文本表示中出现标记的顺序)。 在支持遍历功能的DOM中,DocumentTraversal
将由实现Document接口的相同对象实现。另见Document Object Model (DOM) Level 2 Traversal and Range Specification 。
- 从以下版本开始:
- 9,DOM Level 2
-
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 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
呈现的树的逻辑视图中。 有关可能的SHOW_
值的集合,请参见NodeFilter
的说明。可以使用OR
组合这些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
的TreeWalker
。 设置此值时不考虑whatToShow
标志和NodeFilter
; 任何节点类型都将被接受为root
。currentNode
的TreeWalker
初始化为此节点,无论它是否可见。root
用作在文档结构中向上查看的遍历方法的停止点,例如parentNode
和nextNode。root
不得是null
。 -
whatToShow
- 该标志指定哪些节点类型可以出现在TreeWalker
呈现的树的逻辑视图中。 有关可能的SHOW_
值的集合,请参见NodeFilter
的说明。可以使用OR
组合这些OR
。 -
filter
-该NodeFilter
与该使用TreeWalker
,或null
,表示没有滤波器。 -
entityReferenceExpansion
- 如果此标志为false,则逻辑视图中不显示EntityReference
节点的内容。 - 结果
-
新创建的
TreeWalker
。 - 异常
-
DOMException
- NOT_SUPPORTED_ERR:如果指定的root
是null
则null
。
-
-