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

CKTIS / JavaScript

DocumentFragment — agrupar nós DOM

DocumentFragment agrupa nós DOM sem um elemento de contorno. Ao inserir o fragmento, os seus filhos são movidos e este fica vazio.

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

DocumentFragment é um nó DOM, não um elemento. Crie-o com new DocumentFragment() ou document.createDocumentFragment() para preparar filhos fora da árvore do documento.

parent.appendChild(fragment) move os filhos pela ordem, sem os clonar nem acrescentar um elemento de contorno. O fragmento fica vazio e pode ser reutilizado. O exemplo também verifica a identidade de um nó.

Trata-se de uma API Web, não de uma funcionalidade ECMAScript. O exemplo requer um documento de navegador; o Node 24 não comprova que seja suportado. Não presuma que garante um aumento de velocidade.

Exemplos

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

Resultado

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