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

CKTIS / JavaScript

DocumentFragment — seskupování uzlů DOM

DocumentFragment seskupuje uzly DOM bez obalovacího elementu. Při vložení se jeho potomci přesunou a fragment zůstane prázdný.

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 = new DocumentFragment();
// Alternative:
const otherFragment = document.createDocumentFragment();
fragment.append(node);
parent.appendChild(fragment);

DocumentFragment je uzel DOM, nikoli element. Vytvořte jej pomocí new DocumentFragment() nebo document.createDocumentFragment() a připravte tak potomky mimo strom dokumentu.

parent.appendChild(fragment) přesune potomky ve stejném pořadí, aniž by je klonoval nebo přidával obalovací element. Fragment se vyprázdní a lze jej znovu použít. Příklad také ověřuje identitu uzlu.

Jde o Web API, nikoli o funkci ECMAScriptu. Příklad vyžaduje dokument v prohlížeči; Node 24 nedokazuje podporu. Nepředpokládejte, že zaručuje zvýšení rychlosti.

Příklady

(() => {
  const fragment = new DocumentFragment();
  const list = document.createElement('ul');
  const first = document.createElement('li');
  first.textContent = 'A';
  fragment.append(first);
  const second = document.createElement('li');
  second.textContent = 'B';
  fragment.append(second);

  list.appendChild(fragment);
  console.log(list.textContent);
  console.log(list.children.length);
  console.log(fragment.childNodes.length);
  console.log(list.firstChild === first);
})();

Výsledek

AB
2
0
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