Document: append() 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 Document.append()-Methode
fügt eine Reihe von Node-Objekten oder Zeichenketten nach
dem letzten Kind des Dokuments ein. Zeichenketten
werden als gleichwertige Text-Knoten eingefügt.
Diese Methode fügt ein Kind zu einem Document hinzu. Um ein Kind zu einem beliebigen Element im Baum hinzuzufügen, siehe Element.append().
Syntax
append(param1)
append(param1, param2)
append(param1, param2, /* …, */ paramN)
Parameter
param1, …,paramN-
Eine Reihe von
Node-Objekten oder Zeichenketten, 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
>Einfügen eines Wurzelelements in ein Dokument
Wenn Sie versuchen, ein Element in ein bestehendes HTML-Dokument einzufügen,
kann es einen HierarchyRequestError DOMException auslösen, da ein <html>-Element bereits existiert.
let html = document.createElement("html");
document.append(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.
Wenn Sie ein neues Dokument ohne bestehende Elemente erstellen, können Sie ein HTML-Wurzelelement (oder ein SVG-Wurzelelement) einfügen:
let doc = new Document();
let html = document.createElement("html");
doc.append(html);
doc.children; // HTMLCollection [<html>]
Spezifikationen
| Spezifikation |
|---|
| DOM> # ref-for-dom-parentnode-append①> |