База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

document.createDocumentFragment() — създаване на DOM фрагмент

document.createDocumentFragment() създава празен DOM фрагмент. Можете да съберете възли в него и след това да ги преместите в родителски елемент, без да добавяте допълнителен обвиващ елемент.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const fragment = document.createDocumentFragment();

document.createDocumentFragment() не приема аргументи и връща нов, празен DocumentFragment, свързан с документа, в който е извикана. Това е DOM възел, а не елемент; служи като временен контейнер за други възли.

При target.appendChild(fragment) децата на фрагмента се добавят към target в досегашния им ред, а не самият фрагмент. Възлите се преместват, а не се копират, затова запазват идентичността си. Фрагментът остава празен и може да се използва отново. appendChild() връща подадения фрагмент, а не децата му.

Примерът използва отделен от страницата target, затова не променя видимата страница. Изпълнете го в браузър, в който document е наличен; само JavaScript среда не гарантира тази API.

Примери

{
  const fragment = document.createDocumentFragment();
  const target = document.createElement('ul');

  for (const label of ['A', 'B']) {
    const item = document.createElement('li');
    item.textContent = label;
    fragment.appendChild(item);
  }

  const first = fragment.firstChild;
  const returned = target.appendChild(fragment);

  console.log(target.textContent);
  console.log(target.childNodes.length);
  console.log(fragment.childNodes.length);
  console.log(target.firstChild === first);
  console.log(returned === fragment);
}

Резултат

AB
2
0
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници