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.