Объект NodeIterator.

  NodeIterator - Является интерфейсом к итератору по элементам набора узлов в поддереве dom.
  Такой набор представляет собой выделенную итерируемую последовательность узлов, доступ к которым обеспечивается их перебором (итерацией).
  Эта последовательность строится в соответствии с последовательностью соответствующих элементов тегов в HTML-коде документа (то есть без приоритета уровней вложений).
  Необходимо учитывать, что узлами считаются экземпляры объектов HTMLElement, Text, Comment, и Attr.
  В основе итератора лежит его корневой узел. Корневой узел и всё его поддерево DOM являются структурой, из которой выбираются элементы итератора с помощью Фильтра и маски.
  Экземпляр доступен:

  1. С помощью метода createNodeIterator объекта HTMLDocument
  Свойства.
  filter - Содержит значение аргумента Фильтр, заданное методу createNodeIterator объекта HTMLDocument при создании итератора.
  Значение имеет формат функции.

Формат записи в коде скрипта:

  • Экземпляр объекта NodeIterator.filter

Значения формата записи:

  pointerBeforeReferenceNode - Содержит значение true если опорный узел итератора совпадает с корневым узлом, и false - в противном случае.
  Значение имеет логический формат.
  Опорный узел итератора это узел, от которого будет выполнен переход при вызове методов nextNode или previousNode.
  То есть это узел, на который был выполнен переход предыдущим вызовом методов nextNode или previousNode или корневой узел.

Формат записи в коде скрипта:

  • Экземпляр объекта NodeIterator.pointerBeforeReferenceNode

Значения формата записи:

  referenceNode - Содержит ссылку на экземпляр объекта Node - опорного узла итератора.
  Опорный узел итератора это узел, от которого будет выполнен переход при вызове методов nextNode или previousNode.
  То есть это узел, на который был выполнен переход предыдущим вызовом методов nextNode или previousNode или корневой узел.

Формат записи в коде скрипта:

  • Экземпляр объекта NodeIterator.referenceNode

Значения формата записи:

  root - Содержит ссылку на экземпляр объекта Node - корневого узла итератора.

Формат записи в коде скрипта:

  • Экземпляр объекта NodeIterator.root

Значения формата записи:

  whatToShow - Содержит значение аргумента маска заданное методу createNodeIterator объекта HTMLDocument при создании итератора.
  Значение имеет числовой формат.

Формат записи в коде скрипта:

  • Экземпляр объекта NodeIterator.whatToShow

Значения формата записи:

  Методы.
  detach - Очищает DOM от этого экземпляра объекта NodeIterator.
  Возвращает значение undefined.
  При создании новых итераторов узлов, ранее созданные могут оказываться уже не нужными.
  Метод detach позволяет очистить память от их интерфейсов.

Формат записи в коде скрипта:

  • Экземпляр объекта NodeIterator.detach()

Значения формата записи:

  nextNode - Перемещает позицию итератора на следующий узел.
  Возвращает ссылку на соответствующий экземпляр объекта Node - узла на который переместилась позиция итератора.
  Самый первый вызов nextNode возвращает ссылку на первый узел.
  Если текущий узел является последним узлом, то метод previousNode возвращает значение null, и перемещение не происходит.

Формат записи в коде скрипта:

  • Экземпляр объекта NodeIterator.nextNode()

Значения формата записи:

  previousNode - Перемещает позицию итератора на предыдущий узел.
  Возвращает ссылку на соответствующий экземпляр объекта Node - узла на который переместилась позиция итератора.
  Если текущий узел является самым первым узлом, то метод previousNode возвращает значение null, и перемещение не происходит.

Формат записи в коде скрипта:

  • Экземпляр объекта NodeIterator.previousNode()

Значения формата записи: