Element: before() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。
Element.before() は一連の Node オブジェクトまたは文字列を、この Element の親の子リストの中、この Element の直前に挿入します。文字列は Text ノードと等価なノードとして挿入されます。
構文
js
before(param1)
before(param1, param2)
before(param1, param2, /* … ,*/ paramN)
引数
param1, …,paramN-
挿入する一連の
Nodeオブジェクトまたは文字列です。
返値
なし (undefined)。
例外
HierarchyRequestErrorDOMException-
ノードが階層構造の中の指定された位置に挿入できなかったときに発生します。
例
要素の挿入
js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);
let span = document.createElement("span");
p.before(span);
console.log(container.outerHTML);
// "<div><span></span><p></p></div>"
テキストの挿入
js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);
p.before("Text");
console.log(container.outerHTML);
// "<div>Text<p></p></div>"
要素とテキストの挿入
js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);
let span = document.createElement("span");
p.before(span, "Text");
console.log(container.outerHTML);
// "<div><span></span>Text<p></p></div>"
仕様書
| 仕様書 |
|---|
| DOM # ref-for-dom-childnode-before① |