DocumentFragment: append() メソッド

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>]

仕様書

Specification
DOM Standard
# ref-for-dom-parentnode-append①

ブラウザーの互換性

BCD tables only load in the browser

関連情報