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