DocumentFragment: append() 方法

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本工作。它自 ⁨2018 年 4 月⁩ 起已在所有瀏覽器中可用。

DocumentFragment.append() 方法在文件片段的最後一個子節點之後插入一組 Node 物件或字串。字串會被插入為等效的 Text 節點。

此方法將一個子節點追加到 DocumentFragment。要追加到樹中的任意元素,請參閱 Element.append()

語法

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

引數

param1, …, paramN

要插入的一組 Node 物件或字串。

返回值

無(undefined)。

異常

HierarchyRequestError DOMException

在節點無法插入到層次結構中的指定位置時丟擲。

示例

將元素追加到文件片段

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

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

規範

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

瀏覽器相容性

另見