文件：replaceChildren() 方法

Baseline 已廣泛支援

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

Document.replaceChildren() 方法會將 Document 的現有子元素替換為指定的新的子元素集合。

語法

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

param1, …, paramN: 用於替換 Document 現有子元素的 Node 物件或字串集合。如果未指定替換物件，則 Document 將被清空所有子節點。

無（undefined）。

replaceChildren() 提供了一種非常方便的機制來清空文件的所有子元素。只需在文件物件上呼叫該方法，而不提供任何引數即可實現。

document.replaceChildren();
document.children; // HTMLCollection []

規範
DOM # ref-for-dom-parentnode-replacechildren①

此頁面最後修改於 ⁨2024 年 7 月 12 日⁩，由 MDN 貢獻者修改。