DocumentFragment: replaceChildren() 方法

Baseline 已廣泛支援

此功能已得到充分驗證,並且可在多種裝置和瀏覽器版本上使用。自 ⁨2020 年 10 月⁩ 起,所有瀏覽器均已支援此功能。

DocumentFragment.replaceChildren() 方法使用指定的新子節點集替換 DocumentFragment 中現有的子節點。這些子節點可以是字串或 Node 物件。

語法

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

引數

param1, …, paramN

一組 Node 物件或字串,用於替換 DocumentFragment 中現有的子節點。如果未指定任何替換物件,則 DocumentFragment 將清空所有子節點。

返回值

無(undefined)。

異常

HierarchyRequestError DOMException

當違反 節點樹的約束 時丟擲。

示例

清空文件片段

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①

瀏覽器相容性

另見