Element: 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 April 2018.
Die Element.prepend()-Methode fügt eine Gruppe von Node-Objekten oder Zeichenfolgen vor dem ersten Kind des Element ein. Zeichenfolgen werden als äquivalente Text-Knoten eingefügt.
Syntax
js
prepend(param1) prepend(param1, param2) prepend(param1, param2, /* …, */ paramN) Parameter
param1, …,paramN-
Eine Gruppe von
Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMException-
Ausgelöst, wenn der Knoten nicht an der angegebenen Stelle in der Hierarchie eingefügt werden kann.
Beispiele
Ein Element voranstellen
js
let div = document.createElement("div"); let p = document.createElement("p"); let span = document.createElement("span"); div.append(p); div.prepend(span); console.log(div.childNodes); // NodeList [ <span>, <p> ] Text voranstellen
js
let div = document.createElement("div"); div.append("Some text"); div.prepend("Headline: "); console.log(div.textContent); // "Headline: Some text" Ein Element und Text voranstellen
js
let div = document.createElement("div"); let p = document.createElement("p"); div.prepend("Some text", p); console.log(div.childNodes); // NodeList [ #text "Some text", <p> ] Die prepend-Methode ist nicht einfügbar
Die prepend()-Methode ist nicht in die with-Anweisung eingefügt. Weitere Informationen finden Sie unter Symbol.unscopables.
js
let div = document.createElement("div"); with (div) { prepend("foo"); } // ReferenceError: prepend is not defined Spezifikationen
| Specification |
|---|
| DOM # ref-for-dom-parentnode-prepend① |