CKTIS / JavaScript
document.createDocumentFragment() — criar um fragmento DOM
document.createDocumentFragment() cria um fragmento DOM vazio. Pode reunir nós dentro dele e, depois, movê-los para um elemento pai sem acrescentar um elemento de encapsulamento extra.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const fragment = document.createDocumentFragment();document.createDocumentFragment() não recebe argumentos e devolve um novo DocumentFragment vazio, associado ao documento que faz a chamada. É um nó DOM, não um elemento; funciona como contentor temporário para outros nós.
Com target.appendChild(fragment), os filhos do fragmento são inseridos em target pela ordem que já tinham, e não o próprio fragmento. Os nós são movidos, não copiados, pelo que mantêm a sua identidade. O fragmento fica vazio e pode ser reutilizado. appendChild() devolve o fragmento fornecido, não os seus filhos.
O exemplo usa um target desligado, por isso não altera a página visível. Execute-o num navegador onde document esteja disponível; um ambiente JavaScript, por si só, não garante esta API.
Exemplos
{
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);
}Resultado
AB 2 0 true true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.