DocumentFragment

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

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

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

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

Свойства

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

ParentNode.children Только для чтения Экспериментальная возможность

Возвращает динамическую HTMLCollection содержащую все объекты типа Element, которые являются потомками объекта DocumentFragment.

ParentNode.firstElementChild Только для чтения Экспериментальная возможность

Возвращает Element, который является первым потомком объекта DocumentFragment, или null, если такого нет.

ParentNode.lastElementChild Только для чтения Экспериментальная возможность

Возвращает Element, который является последним потомком объекта DocumentFragment, или null, если такого нет.

ParentNode.childElementCount Только для чтения Экспериментальная возможность

Возвращает unsigned long - число потомков объекта DocumentFragment.

Конструктор

DocumentFragment() Экспериментальная возможность

Возвращает пустой объект DocumentFragment.

Методы

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

DocumentFragment.find() Экспериментальная возможность

Возвращает первое совпадение Element в дереве DocumentFragment.

DocumentFragment.findAll() Экспериментальная возможность

Возвращает список NodeList найденных Element в дереве DocumentFragment.

DocumentFragment.querySelector()

Возвращает первый узел Element в DocumentFragment, в порядке документа, который совпадает с заданным селектором.

DocumentFragment.querySelectorAll()

Возвращает список NodeList всех узлов Element в DocumentFragment которые совпадают с заданным селектором.

DocumentFragment.getElementById()

Возвращает первый узел Element в DocumentFragment, в порядке документа, который совпадает с заданным ID.

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

Specification
DOM
# interface-documentfragment

Совместимость с браузерами

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
DocumentFragment
DocumentFragment() constructor
append
childElementCount
children
firstElementChild
getElementById
lastElementChild
moveBefore
Experimental
prepend
querySelector
querySelectorAll
replaceChildren

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.

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