MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Интерфейс 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 Только для чтения
Returns the Element that is the first child of the DocumentFragment object, or null if there is none.
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() Нет Нет Нет Нет Нет

DocumentFragment() конструктор

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  Нет Нет Нет Нет Нет

Смотри также

Метки документа и участники

 Внесли вклад в эту страницу: tarkus, vgsdesign
 Обновлялась последний раз: tarkus,