Document:append() 方法
**Document.append()
** 方法在文档的最后一个子节点之后插入一组Node
对象或字符串。字符串将作为等效的Text
节点插入。
此方法将子节点附加到 Document
。要附加到树中的任意元素,请参见Element.append()
。
语法
js
append(param1)
append(param1, param2)
append(param1, param2, /* …, */ paramN)
参数
返回值
无(undefined
)。
异常
HierarchyRequestError
DOMException
-
当节点无法插入层次结构中的指定点时抛出。
示例
将根元素附加到文档
如果尝试将元素附加到现有的 HTML 文档,则可能会抛出 HierarchyRequestError
DOMException
,因为已经存在 <html>
元素。
js
let html = document.createElement("html");
document.append(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.
如果创建了一个没有任何现有元素的新文档,则可以附加一个根 HTML 元素(或根 SVG 元素)。
js
let doc = new Document();
let html = document.createElement("html");
doc.append(html);
doc.children; // HTMLCollection [<html>]
规范
规范 |
---|
DOM 标准 # ref-for-dom-parentnode-append① |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。