-
public interface DocumentTraversalDocumentTraversal包含创建NodeIterators和TreeWalkers以按文档顺序遍历节点及其子节点的方法(深度优先,预订遍历,等效于文档的文本表示中起始标签出现的顺序)。 在支持Traversal功能的DOM中,DocumentTraversal将由实现Document界面的相同对象实现。另见Document Object Model (DOM) Level 2 Traversal and Range Specification 。
- 从以下版本开始:
- 9,DOM Level 2
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 NodeIteratorcreateNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)在指定节点上生成的子NodeIterator创建一个新的NodeIterator。TreeWalkercreateTreeWalker(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。
-
-