1. 開発者向けのウェブ技術
  2. Web API
  3. CharacterData
  4. CharacterData: replaceWith() メソッド

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

CharacterData: replaceWith() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。

replaceWith()CharacterData インターフェイスのメソッドで、親ノードの子リスト内にあるこのノードを、一連の Node オブジェクトまたは文字列で置き換えます。

文字列は Text ノードとして置き換えられます。この文字列は Text() コンストラクターに引数として渡されます。

構文

js
replaceWith(nodes)

引数

nodes 省略可

カンマ区切りの Node オブジェクトまたは文字列のリストで、現在のノードを置き換えるものです。

メモ: 引数が渡されなかった場合、このメソッドはこのノードを DOM ツリーから取り除くだけの動作をします。

返値

なし (undefined)。

例外

HierarchyRequestError DOMException

ノードが階層内の指定された位置に挿入できない場合に発生します。

html
<p id="myText">Some text</p>
js
let text = document.getElementById("myText").firstChild;
let em = document.createElement("em");
em.textContent = "Italic text";
text.replaceWith(em); // `Some text` を `Italic text` で置き換える

仕様書

仕様書
DOM
# ref-for-dom-childnode-replacewith1

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

AltStyle によって変換されたページ (->オリジナル) /