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() があります。