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 April 2018.
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
| Specification |
|---|
| DOM # ref-for-dom-parentnode-append① |
Browser-Kompatibilität
Loading…