CKTIS / JavaScript
document.createDocumentFragment() — ustvarjanje fragmenta DOM
document.createDocumentFragment() ustvari prazen fragment DOM. Vanj lahko zberete vozlišča in jih nato premaknete v nadrejeni element, ne da bi dodali dodaten ovojni element.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const fragment = document.createDocumentFragment();document.createDocumentFragment() ne sprejema argumentov in vrne nov prazen DocumentFragment, povezan z dokumentom, v katerem je bil klic izveden. To je vozlišče DOM, ne element; služi kot začasna vsebniška struktura za druga vozlišča.
Pri target.appendChild(fragment) se otroci fragmenta dodajo v target v svojem obstoječem vrstnem redu, ne pa sam fragment. Vozlišča se premaknejo, ne kopirajo, zato ohranijo svojo identiteto. Fragment postane prazen in ga je mogoče znova uporabiti. appendChild() vrne podani fragment, ne njegovih otrok.
Primer uporablja odklopljen target, zato ne spremeni vidne strani. Zaženite ga v brskalniku, kjer je na voljo document; samo okolje JavaScript te API ne zagotavlja.
Primeri
{
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);
}Rezultat
AB 2 0 true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.