Element: before()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
Die Methode before() der Schnittstelle Element fügt eine Gruppe von Node-Objekten oder Zeichenfolgen in die Liste der Kindknoten des Elternelements dieses Element ein, unmittelbar vor diesem Element. Zeichenfolgen werden als entsprechende Text-Knoten eingefügt. Wenn parentNode null ist, geschieht nichts.
Syntax
js
before(param1)
before(param1, param2)
before(param1, param2, /* …, */ paramN)
Parameter
param1, …,paramN-
Eine Gruppe von
Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMException-
Wird ausgelöst, wenn der Knoten an der angegebenen Stelle in der Hierarchie nicht eingefügt werden kann.
Beispiele
Ein Element einfügen
js
const container = document.createElement("div");
const p = document.createElement("p");
container.appendChild(p);
const span = document.createElement("span");
p.before(span);
console.log(container.outerHTML);
// "<div><span></span><p></p></div>"
Text einfügen
js
const container = document.createElement("div");
const p = document.createElement("p");
container.appendChild(p);
p.before("Text");
console.log(container.outerHTML);
// "<div>Text<p></p></div>"
Ein Element und Text einfügen
js
const container = document.createElement("div");
const p = document.createElement("p");
container.appendChild(p);
const span = document.createElement("span");
p.before(span, "Text");
console.log(container.outerHTML);
// "<div><span></span>Text<p></p></div>"
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-childnode-before① |