Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

document.createDocumentFragment() — creare un frammento DOM

document.createDocumentFragment() crea un frammento DOM vuoto. Puoi raccogliervi dei nodi e poi spostarli in un elemento padre senza aggiungere un ulteriore elemento contenitore.

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

Sintassi

const fragment = document.createDocumentFragment();

document.createDocumentFragment() non accetta argomenti e restituisce un nuovo DocumentFragment vuoto, associato al documento che esegue la chiamata. È un nodo DOM, non un elemento; funge da contenitore temporaneo per altri nodi.

Con target.appendChild(fragment), i figli del frammento vengono inseriti in target nell’ordine che avevano, non viene inserito il frammento stesso. I nodi vengono spostati, non copiati, quindi conservano la propria identità. Il frammento diventa vuoto e può essere riutilizzato. appendChild() restituisce il frammento passato, non i suoi figli.

L’esempio usa un target scollegato, quindi non modifica la pagina visibile. Eseguilo in un browser in cui document sia disponibile; un ambiente JavaScript da solo non garantisce questa API.

Esempi

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

Risultato

AB
2
0
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti