DocumentFragment: prepend() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。
DocumentFragment.prepend() メソッドは、一連の Node オブジェクトまたは文字列を、この文書フラグメントにおける最初の子の前に挿入します。文字列は同等の Text ノードとして挿入されます。
このメソッドは、DocumentFragment の先頭に子要素を挿入します。ツリー内の任意の要素に挿入する場合は、 Element.prepend() を参照してください。
構文
js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* … ,*/ paramN)
引数
param1, …,paramN-
挿入する一連の
Nodeまたは文字列です。
返値
なし (undefined)。
例外
HierarchyRequestErrorDOMException-
階層内の指定された位置にノードが挿入できなかった場合に発生します。
例
Prepending an element to a document fragment
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>]
仕様書
| 仕様書 |
|---|
| DOM # ref-for-dom-parentnode-prepend① |