Dokument: 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 Document.prepend()-Methode fügt eine Reihe von Node-Objekten oder Zeichenfolgen vor dem ersten Kind des Dokuments ein. Zeichenfolgen werden als gleichwertige Text-Knoten eingefügt.
Diese Methode stellt ein Kind einem Document voran. Um ein Element an einer beliebigen Stelle im Baum voranzustellen, siehe Element.prepend().
Syntax
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)
Parameter
param1, …,paramN-
Eine Reihe 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 Wurzelelement in ein Dokument voranstellen
Wenn Sie versuchen, ein Element einem bestehenden HTML-Dokument voranzustellen, könnte ein HierarchyRequestError DOMException auftreten, wenn bereits ein <html>-Element existiert.
let html = document.createElement("html");
document.prepend(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.
Wenn Sie ein neues Dokument ohne vorhandene Elemente erstellen, können Sie ein Wurzel-HTML-Element (oder ein Wurzel-SVG-Element) voranstellen:
let doc = new Document();
let html = document.createElement("html");
doc.prepend(html);
doc.children; // HTMLCollection [<html>]
Spezifikationen
| Specification |
|---|
| DOM> # ref-for-dom-parentnode-prepend①> |
Browser-Kompatibilität
Loading…