DocumentFragment

Интерфейс DocumentFragment представляет собой минимальный объект документа, который не имеет родителя. Он используется как лёгкая версия  Document, чтобы хранить хорошо сформированные или потенциально не хорошо формированные фрагменты XML.

Различные другие методы могут взять document fragment в качестве аргумента (например, любые методы интерфейса Node, такие как Node.appendChild и Node.insertBefore), в этом случае прикрепляются или вставляются  дети фрагмента, а не сам фрагмент.

Этот интерфейс также хорошо используется с веб-компонентами: <template>  элементы содержат DocumentFragment в их HTML Template Element.content свойствах.

Пустой DocumentFragment может быть создан с помощью метода document.createDocumentFragment  или конструктора.

Свойства

Этот интерфейс не имеет определённых свойств помимо наследуемых от его родителя, Node, и реализует их из интерфейса ParentNode.

ParentNode.children (en-US) Только для чтения Experimental
Возвращает динамическую HTMLCollection содержащую все объекты типа Element, которые являются потомками объекта DocumentFragment.
ParentNode.firstElementChild (en-US) Только для чтения Experimental
Возвращает Element, который является первым потомком объекта DocumentFragment, или null, если такого нет.
ParentNode.lastElementChild (en-US) Только для чтения Experimental
Возвращает Element, который является последним потомком объекта DocumentFragment, или null, если такого нет.
ParentNode.childElementCount Только для чтения Experimental
Возвращает unsigned long - число потомков объекта DocumentFragment.

Конструктор

DocumentFragment() (en-US) Experimental
Возвращает пустой объект DocumentFragment.

Методы

Этот интерфейс наследует методы его родителя, Node, и реализует их из интерфейса ParentNode.

DocumentFragment.find() Experimental
Возвращает первое совпадение Element в дереве DocumentFragment.
DocumentFragment.findAll() Experimental
Возвращает список NodeList найденных Element в дереве DocumentFragment.
DocumentFragment.querySelector() (en-US)
Возвращает первый узел Element в DocumentFragment, в порядке документа, который совпадает с заданным селектором.
DocumentFragment.querySelectorAll() (en-US)
Возвращает список NodeList всех узлов Element в DocumentFragment которые совпадают с заданным селектором.
DocumentFragment.getElementById()
Возвращает первый узел Element в DocumentFragment, в порядке документа, который совпадает с заданным ID.

Спецификации

Specification
DOM Standard
# interface-documentfragment

Поддержка браузерами

BCD tables only load in the browser

Смотрите также