WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

document.createDocumentFragment() — ein DOM-Fragment erstellen

document.createDocumentFragment() erstellt ein leeres DOM-Fragment. Darin kannst du Knoten sammeln und sie anschließend in ein Elternelement verschieben, ohne ein zusätzliches Wrapper-Element einzufügen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const fragment = document.createDocumentFragment();

document.createDocumentFragment() erwartet keine Argumente und gibt ein neues, leeres DocumentFragment zurück, das dem aufrufenden Dokument zugeordnet ist. Es ist ein DOM-Knoten, kein Element, und dient als temporärer Behälter für andere Knoten.

Bei target.appendChild(fragment) werden die Kinder des Fragments in ihrer bisherigen Reihenfolge in target eingefügt, nicht das Fragment selbst. Die Knoten werden verschoben, nicht kopiert, und behalten daher ihre Identität. Das Fragment ist danach leer und kann wiederverwendet werden. appendChild() gibt das übergebene Fragment zurück, nicht dessen Kinder.

Das Beispiel verwendet ein nicht angehängtes target und verändert daher die sichtbare Seite nicht. Führe es in einem Browser aus, in dem document verfügbar ist; eine JavaScript-Laufzeit allein garantiert diese API nicht.

Beispiele

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

Ergebnis

AB
2
0
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen