Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

document.createDocumentFragment() — vytvoření fragmentu DOM

document.createDocumentFragment() vytvoří prázdný fragment DOM. Můžete v něm shromáždit uzly a potom je přesunout do rodiče, aniž byste přidali další obalový prvek.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const fragment = document.createDocumentFragment();

document.createDocumentFragment() nepřijímá žádné argumenty a vrací nový prázdný DocumentFragment přiřazený k dokumentu, na kterém byla metoda zavolána. Je to uzel DOM, nikoli element; slouží jako dočasný kontejner pro jiné uzly.

Při použití target.appendChild(fragment) se do target vloží děti fragmentu v jejich dosavadním pořadí, nikoli samotný fragment. Uzly se přesunou, nezkopírují, a zachovají si tak svou identitu. Fragment se vyprázdní a lze ho znovu použít. appendChild() vrací předaný fragment, nikoli jeho děti.

Příklad používá odpojený target, takže viditelnou stránku nezmění. Spusťte ho v prohlížeči, kde je dostupný document; samotné prostředí JavaScriptu tuto API nezaručuje.

Příklady

{
  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);
}

Výsledek

AB
2
0
true
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje