Element: prepend() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。
Element.prepend() メソッドは、一連の Node または文字列をこの Element の最初の子の前に挿入します。文字列は、同等の Text ノードとして挿入されます。
構文
js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)
引数
param1, …,paramN-
挿入する一連の
Nodeまたは文字列です。
返値
なし (undefined)。
例外
HierarchyRequestErrorDOMException-
ノードを階層の指定された箇所に追加することができない場合に発生します。
例
要素の前に追加
js
let div = document.createElement("div");
let p = document.createElement("p");
let span = document.createElement("span");
div.append(p);
div.prepend(span);
console.log(div.childNodes); // NodeList [ <span>, <p> ]
テキストの前に追加
js
let div = document.createElement("div");
div.append("Some text");
div.prepend("Headline: ");
console.log(div.textContent); // "Headline: Some text"
要素とテキストの追加
js
let div = document.createElement("div");
let p = document.createElement("p");
div.prepend("Some text", p);
console.log(div.childNodes); // NodeList [ #text "Some text", <p> ]
prepend() メソッドはスコープが効かない
prepend() メソッドは with 文の中ではスコープが効きません。詳しくは Symbol.unscopables をご覧ください。
js
let div = document.createElement("div");
with (div) {
prepend("foo");
}
// ReferenceError: prepend is not defined
仕様書
| 仕様書 |
|---|
| DOM # ref-for-dom-parentnode-prepend① |