DocumentFragment：prepend() 方法

DocumentFragment.prepend() 方法在文档片段的第一个子节点之前插入一组 Node 对象或字符串。字符串将作为等效的 Text 节点插入。

此方法将子节点添加到 DocumentFragment 的开头。要将节点添加到树中的任意元素的开头，请参见 Element.prepend()。

语法

js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)

参数

param1, …, paramN

要插入的一组 Node 对象或字符串。

返回值

无 (undefined).

异常

HierarchyRequestError DOMException

当节点无法插入到层次结构中的指定位置时抛出。

示例

将元素添加到文档片段的开头

js
let fragment = new DocumentFragment();
let div = document.createElement("div");
let p = document.createElement("p");
fragment.append(p);
fragment.prepend(div);

fragment.children; // HTMLCollection [<div>, <p>]

规范

规范
DOM 标准
# ref-for-dom-parentnode-prepend①

浏览器兼容性

BCD 表仅在启用了 JavaScript 的浏览器中加载。

另请参阅