Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri