1. Веб-технологии для разработчиков
  2. Интерфейсы веб API
  3. DocumentFragment

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

DocumentFragment

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..

* Some parts of this feature may have varying levels of support.

Интерфейс 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

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

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

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content