replaceChild() メソッド
Node.replaceChild()
replaceChild() メソッドは、子オブジェクトの置換を行う Node インターフェイスのメソッドです。 第2引数は、 Node オブジェクトの子オブジェクトである必要があります。第2引数のオブジェクトを第1引数のオブジェクトに置き換えます。
Node.replaceChild( new_Node, old_Node );
詳しくは Example を参照してください
もしも置き換えるための第1引数のオブジェクトが既に存在している場合は、そのオブジェクトが移動して第2引数のオブジェクトと置き換わります。
このメソッドはNode インターフェイスのメソッドで、インターフェイスを継承する Document 、Element オブジェクトで共通して利用できます。
ページ内 Index
Syntax
in JavaScript
old_Node = Node.replaceChild( new_Node, old_Node );
返り値は、置換されたオブジェクトです。
引数（Parameter Values）
| Value | 摘要 |
|---|---|
| new_Node | 置き換えるオブジェクト。既存の場合は移動して置換 |
| old_Node | 置換されるオブジェクト |
返り値（Return Values）
| Type | 摘要 |
|---|---|
| old_Node | 置換されるオブジェクトが返る |
Example
.replaceChild() メソッドの例です。
関連するメソッド
Node インターフェイスにおいて関連するメソッドには以下があります。Element オブジェクトではなく、Node オブジェクトや NodeList を返す場合があります。
| 関連メソッド | 概要 |
|---|---|
| .appendChild() | 引数の Node を最後尾に追加 |
| .cloneNode() | Nodeを複製 |
| .compareDocumentPosition() | ノードの相対的な位置 |
| .contains() | 引数のNodeが子孫か否か Boolean型 |
| .getBoxQuads() | NodeのCSSにおいて関連するNodeをリストで返す |
| .getRootNode() | NodeのルートNodeを返す |
| .hasChildNodes() | 子Nodeを持っているか Boolean型 |
| .insertBefore() | Nodeを指定Nodeの前に挿入 |
| .normalize() | 全てのテキストNodeを削除 |
| .removeChild() | 指定した子Nodeを削除 |
| .replaceChild() | 指定した子Nodeを置き換える |
似たメソッドに Element.replaceWith() があります。