DOM
Document.append() 方法会在文档的最后一个子节点后插入一组Node对象或字符串对象。字符串对象被插入为相同Text节点。
此方法将一个子元素追加到 Document 中。要向树中的任意元素添加子元素,请参阅 Element.append()。
语法
append(param1)
append(param1, param2)
append(param1, param2, /* …, */ paramN)
参数
param1, …,paramN- : 要插入的一组 Node 或字符串对象。
返回值
无(undefined)。
异常
HierarchyRequestErrorDOMException- : 当节点无法插入层次结构中的指定点时抛出异常。
示例
向文档添加根元素
如果你尝试在现有 HTML 文档中添加元素,可能会抛出 HierarchyRequestError DOMException,因为 html 元素已经存在。
let html = document.createElement("html");
document.append(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.
如果创建的新文档没有任何现有元素,你可以添加一个 HTML 根元素(或 SVG 根元素):
let doc = new Document();
let html = document.createElement("html");
doc.append(html);
doc.children; // HTMLCollection [<html>]
规范
浏览器兼容性
参见
- Document.prepend()
- Element.append()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
