DocumentFragment: prepend() メソッド
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
DocumentFragment.prepend()
メソッドは、一連の Node
オブジェクトまたは文字列を、この文書フラグメントにおける最初の子の前に挿入します。文字列は同等の Text
ノードとして挿入されます。
このメソッドは、DocumentFragment
の先頭に子要素を挿入します。ツリー内の任意の要素に挿入する場合は、 Element.prepend()
を参照してください。
構文
js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* … ,*/ paramN)
引数
param1
, …,paramN
-
挿入する一連の
Node
または文字列です。
返値
なし (undefined
)。
例外
HierarchyRequestError
DOMException
-
階層内の指定された位置にノードが挿入できなかった場合に発生します。
例
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>]
仕様書
Specification |
---|
DOM Standard # ref-for-dom-parentnode-prepend① |
ブラウザーの互換性
BCD tables only load in the browser