Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes