DocumentFragment: replaceChildren() 方法
DocumentFragment.replaceChildren() 方法将 DocumentFragment 的现有子节点替换为指定的新子节点集。这些可以是字符串或 Node 对象。
语法
js
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)
参数
返回值
无 (undefined).
异常
HierarchyRequestErrorDOMException-
当违反 节点树约束 时抛出。
示例
清空文档片段
replaceChildren() 提供了一种非常方便的机制，用于清空文档片段中的所有子节点。您可以在文档片段上调用它，而不指定任何参数。
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>]
fragment.replaceChildren();
fragment.children; // HTMLCollection []
规范
| 规范 |
|---|
| DOM 标准 # ref-for-dom-parentnode-replacechildren① |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。