Эта страница была переведена с английского языка силами сообщества. Вы тоже можете внести свой вклад, присоединившись к русскоязычному сообществу MDN Web Docs.

Document.createDocumentFragment()

Создаёт новый пустой DocumentFragment.

Syntax

var fragment = document.createDocumentFragment();

fragment это ссылка на пустой объект DocumentFragment.

Description

DocumentFragments являются DOM нодами. Они, при этом, не являются частями основного дерева DOM. Обычно используются для создания фрагмента документа, добавления в него новых элементов/нод, а затем присоединения этого фрагмента к основному дереву. В основном дереве фрагмент буден заменён собственными дочерними элементами.

Поскольку фрагмент документа хранится в памяти и не является частью основного дерева, добавление в него дочерних элементов не вызывает reflow (вычисление геометрии и позиций элементов). В следствие этого, использование фрагментов документа часто увеличивает производительность.

Example

var element  = document.getElementById('ul'); // assuming ul exists
var fragment = document.createDocumentFragment();
var browsers = ['Firefox', 'Chrome', 'Opera',
    'Safari', 'Internet Explorer'];

browsers.forEach(function(browser) {
    var li = document.createElement('li');
    li.textContent = browser;
    fragment.appendChild(li);
});

element.appendChild(fragment);

Specifications

Specification Status Comment
DOM
Определение 'Document.createDocumentFragment()' в этой спецификации.		 Живой стандарт No change
DOM4
Определение 'Document.createDocumentFragment()' в этой спецификации.		 Устаревшая Clarifies that the node document of the created document fragment is the context object.
Document Object Model (DOM) Level 3 Core Specification
Определение 'Document.createDocumentFragment()' в этой спецификации.		 Устаревшая No change
Document Object Model (DOM) Level 2 Core Specification
Определение 'Document.createDocumentFragment()' в этой спецификации.		 Устаревшая No change
Document Object Model (DOM) Level 1 Specification
Определение 'Document.createDocumentFragment()' в этой спецификации.		 Устаревшая Initial definition

Browser compatibility

BCD tables only load in the browser

See also