.replaceChild()

特定の要素の子ノードを、別の要素と置き換えます。

文法

replacedNode = parentNode.replaceChild(newChild, oldChild);
引数 説明
newChild oldChildと置き換える新しいノードを指定します。 DOM内に存在するノードであれば、始めにその削除が行われます。
oldChild 置き換えられる子ノードを指定します。
戻り値
replacedNode 置き換えられたノードが返されます。 これはoldChildと同じになります。

// <div>
//  <span id="childSpan">foo bar</span>
// </div>


// ID、属性、内容が無い、空の要素ノードを作成します。
var sp1 = document.createElement("span");

// 'newSpan'のID属性を割り当てます。
sp1.setAttribute("id", "newSpan");

// 上記の要素のための、内容(テキストノード)を作成します。
var sp1_content = document.createTextNode("new replacement span element.");

// 要素に作成した内容を適用します。
sp1.appendChild(sp1_content);

// 置き換えが行われる既存のノードへの参照を作成します。
var sp2 = document.getElementById("childSpan");
var parentDiv = sp2.parentNode;

// 既存のノードであるsp2を、
// 新しいspan要素であるsp1と置き換えます。
parentDiv.replaceChild(sp1, sp2);


// 結果:
// <div>
//   <span id="newSpan">new replacement span element.</span>
// </div>

注意事項

仕様

 Back to top

© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。

  • 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
  • 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
  • MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
  • "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。