DocumentFragment: prepend() Methode

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.

Die DocumentFragment.prepend()-Methode fügt eine Menge von Node-Objekten oder Zeichenfolgen vor dem ersten Kind des Dokumentfragments ein. Zeichenfolgen werden als äquivalente Text-Knoten eingefügt.

Diese Methode fügt ein Kind zu einem DocumentFragment hinzu. Um ein beliebiges Element im Baum voranzustellen, siehe Element.prepend().

Syntax

js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)

Parameter

param1, …, paramN

Eine Menge von Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException

Wird ausgelöst, wenn der Knoten an der angegebenen Stelle in der Hierarchie nicht eingefügt werden kann.

Beispiele

Ein Element einem Dokumentfragment voranstellen

js
let fragment = new DocumentFragment();
let div = document.createElement("div");
let p = document.createElement("p");
fragment.append(p);
fragment.prepend(div);

fragment.children; // HTMLCollection [<div>, <p>]

Spezifikationen

Specification
DOM Standard
# ref-for-dom-parentnode-prepend①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch