Document: append() 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 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
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
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
Specification |
---|
DOM Standard # ref-for-dom-parentnode-append① |
Browser-Kompatibilität
BCD tables only load in the browser