Интерфейс DocumentTraversal

public interface DocumentTraversal

DocumentTraversal содержит методы, которые создают NodeIterators и TreeWalkers для обхода узла и его потомков в порядке документа (поиск в глубину, прямой обход, который эквивалентен порядку, в котором появляются открывающие теги в текстовом представлении документа). В DOM, поддерживающих функцию Traversal, DocumentTraversal будут реализованы теми же объектами, что и интерфейс Document.

См. также Спецификацию DOM Level 2 Traversal и Range.

Since:: 9, DOM Level 2

Методы

Модификатор и тип	Метод	Описание
`NodeIterator`	`createNodeIterator(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)`	Создать новый `NodeIterator` над поддеревом, укорененным в указанном узле.
`TreeWalker`	`createTreeWalker(Node root, int whatToShow, NodeFilter filter, boolean entityReferenceExpansion)`	Создать новый `TreeWalker` над поддеревом, укорененным в указанном узле.

Методы

createNodeIterator

NodeIterator createNodeIterator(Node root,
                                int whatToShow,
                                NodeFilter filter,
                                boolean entityReferenceExpansion)
                         throws DOMException

Создать новый NodeIterator над поддеревом, укорененным в указанном узле.

Параметры:: root - Узел, который будет перебираться вместе с его потомками. Позиция NodeIterator первоначально установлена непосредственно перед этим узлом. Флаги whatToShow и, при необходимости, фильтр не учитываются при установке этой позиции. Корень не должен быть null.; whatToShow - Этот флаг определяет типы узлов, которые могут появляться в логическом представлении дерева, представленном NodeIterator. См. описание NodeFilter для набора возможных значений SHOW_. Эти флаги можно объединять с помощью OR.; filter - NodeFilter для использования с этим NodeIterator, или null для указания отсутствия фильтра.; entityReferenceExpansion - Значение этого флага определяет, расширяются ли узлы ссылок на сущности.
Возвращает:: Созданный NodeIterator.
Исключения:: DOMException - NOT_SUPPORTED_ERR: Возникает, если указанный root null.

createTreeWalker

TreeWalker createTreeWalker(Node root,
                            int whatToShow,
                            NodeFilter filter,
                            boolean entityReferenceExpansion)
                     throws DOMException

Создать новый TreeWalker над поддеревом, укорененным в указанном узле.

Параметры:: 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.