Интерфейс 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.
Спецификации
Спецификация | Статус | Комментарий |
---|---|---|
DOM Определение 'DocumentFragment' в этой спецификации. |
Живой стандарт | Добавлены конструктор и реализация ParentNode . |
Selectors API Level 2 Определение 'DocumentFragment' в этой спецификации. |
Устаревшая | Добавлены методы find() и findAll() . |
Selectors API Level 1 Определение 'DocumentFragment' в этой спецификации. |
Устаревшая | Добавлены методы querySelector() и querySelectorAll() . |
Document Object Model (DOM) Level 3 Core Specification Определение 'DocumentFragment' в этой спецификации. |
Устаревшая | Нет изменений с Document Object Model (DOM) Level 2 Core Specification |
Document Object Model (DOM) Level 2 Core Specification Определение 'DocumentFragment' в этой спецификации. |
Устаревшая | Нет изменений с Document Object Model (DOM) Level 1 Specification |
Document Object Model (DOM) Level 1 Specification Определение 'DocumentFragment' в этой спецификации. |
Устаревшая | Первоначальное определение |
Поддержка браузерами
Характеристика | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Базовая поддержка | 1.0 | 1.0 (1.7 или ранее) | (Да) | (Да) | (Да) |
querySelector() и querySelectorAll() |
1.0 | 3.5 (1.9.1) | 8.0 | 10.0 | 3.2 (525.3) |
findAll() и find() |
Нет | Нет | Нет | Нет | Нет |
|
28.0 | 24.0 (24.0) | Нет | 15.0 | Нет |
Свойства ParentNode |
28.0 | 25.0 (25.0) | Нет | 15.0 | Нет |
Методы ParentNode |
Нет | Нет | Нет | Нет | Нет |
Характеристика | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Да) | 1.0 (1.0) | (Да) | (Да) | (Да) |
querySelector() и querySelectorAll() |
2.1 | 1.0 (1.0) | 8.0 | 10.0 | 3.2 (525.3) |
findAll() и find() |
Нет | Нет | Нет | Нет | Нет |
DocumentFragment() конструктор |
? | 24.0 (24.0) | Нет | ? | ? |
Свойства ParentNode |
(Да) | 25.0 (25.0) | Нет | 5.0 | Нет |
Методы ParentNode |
Нет | Нет | Нет | Нет | Нет |