Document: Methode createDocumentFragment()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Erstellt ein neues leeres DocumentFragment, in das DOM-Knoten hinzugefügt werden können, um einen Offscreen-DOM-Baum zu erstellen.

Syntax

js
createDocumentFragment()

Parameter

Keine.

Rückgabewert

Ein neu erstelltes, leeres DocumentFragment-Objekt, das bereit ist, Knoten einzufügen.

Anwendungshinweise

DocumentFragments sind DOM-Node-Objekte, die niemals Teil des Haupt-DOM-Baums sind. Der übliche Anwendungsfall besteht darin, das Dokumentfragment zu erstellen, Elemente an das Dokumentfragment anzuhängen und dann das Dokumentfragment an den DOM-Baum anzuhängen. Im DOM-Baum wird das Dokumentfragment durch all seine Kinder ersetzt.

Da das Dokumentfragment im Speicher und nicht Teil des Haupt-DOM-Baums ist, könnte die Verwendung von Dokumentfragmenten in einigen älteren Engines zu besserer Leistung führen.

Sie können auch den DocumentFragment-Konstruktor verwenden, um ein neues Fragment zu erstellen:

js
const fragment = new DocumentFragment();

Beispiele

Dieses Beispiel erstellt eine Liste der wichtigsten Webbrowser in einem DocumentFragment und fügt dann den neuen DOM-Unterbaum dem Dokument hinzu, das angezeigt werden soll.

HTML

html
<ul id="ul"></ul>

JavaScript

js
const element = document.getElementById("ul"); // assuming ul exists
const fragment = document.createDocumentFragment();
const browsers = ["Firefox", "Chrome", "Opera", "Safari"];

browsers.forEach((browser) => {
  const li = document.createElement("li");
  li.textContent = browser;
  fragment.appendChild(li);
});

element.appendChild(fragment);

Ergebnis

Spezifikationen

Specification
DOM
# ref-for-dom-document-createdocumentfragment①

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
createDocumentFragment

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch