Element: append() メソッド
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.
Element.append()
メソッドは、一連の Node
オブジェクトまたは文字列を Element
の最後の子の後に挿入します。文字列は、等価な Text
ノードとして挿入されます。
Node.appendChild()
との違いは次の通りです。
構文
js
append(param1)
append(param1, param2)
append(param1, param2, /* … ,*/ paramN)
引数
param1
, …,paramN
-
挿入する一連の
Node
オブジェクトまたは文字列です。
返値
なし (undefined
)。
例外
HierarchyRequestError
DOMException
-
ノードが階層構造の中の指定された位置に挿入できなかったときに発生します。
例
要素の追加
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
仕様書
Specification |
---|
DOM Standard # ref-for-dom-parentnode-append① |
ブラウザーの互換性
BCD tables only load in the browser