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.