DocumentFragment
Интерфейс 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 Standard # interface-documentfragment |
Совместимость с браузерами
BCD tables only load in the browser