Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DocumentFragment — raggruppare nodi DOM

DocumentFragment raggruppa nodi DOM senza un elemento contenitore. Quando si inserisce il frammento, i suoi figli vengono spostati e il frammento resta vuoto.

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

DocumentFragment è un nodo DOM, non un elemento. Crealo con new DocumentFragment() oppure document.createDocumentFragment() per preparare i figli al di fuori dell’albero del documento.

parent.appendChild(fragment) sposta i figli nell’ordine, senza clonarli né aggiungere un elemento contenitore. Il frammento diventa vuoto e può essere riutilizzato. L’esempio verifica anche l’identità di un nodo.

È una Web API, non una funzionalità ECMAScript. L’esempio richiede un documento del browser; Node 24 non dimostra che sia supportata. Non dare per scontato che garantisca un miglioramento delle prestazioni.

Esempi

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

Risultato

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