DOM

Text.replaceWholeText() メソッド

 編集:2022.10.31 by T.A.

[Edge]。非推奨 削除。→

非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

Text…¶

mdn: ノードのテキストと、論理的に隣接するすべてのテキスト ノードを指定されたテキストで置き換えます。置換されたノードは、現在のノードを含め、置換テキストを受け取るものでない限り、削除されます。

mdn: メモ: 現代のブラウザーで同じ効果を達成するには、Node.textContentElement.innerHTMLHTMLElement.innerTextCharacterData.replaceData() を使用することを検討してください。

構文

mdn:

Text.replaceWholeText(content)

¶修正:

Text.replaceWholeText = content
Text Text
content 置き換えるテキストを表す文字列です。

メモ: 省略不可ですが、空文字列("")に設定することはできます。

戻り値

置き換えたテキストを表す文字列。

mdn: 置き換えられた文字列の Text ノード、または置き換える文字列が "" であった場合は null です。

例外
NoModificationError(DOMException
置き換えられるテキスト ノードすべてが読み取り専用であった場合に発生します。

HTML:

<SPAN id=IdTest>[SPAN要素]</SPAN><BR>

JavaScript:

N=new Text("テストテキスト");  //テキスト ノードの生成。
IdTest.appendChild(N);         //それを IdTest の子ノードの末尾に追加。
NL=IdTest.childNodes;  //IdTest の子ノード リストを得る。
	//=[object]:[object NodeList]
	//0=[object]:[object Text]
	//1=[object]:[object Text]
	//entries=[function]:function entries() { [native code] }
	//
//D=NL[0].replaceWholeText("テストテキスト");  //エラー発生:NL[0].replaceWholeText is not a function
D=NL[0].replaceWholeText="テストテキスト";  //=[string]:テストテキスト
DA=IdTest.outerHTML;  //IdTest の全体。
	//=[string]:<span id="IdTest">[SPAN要素]テストテキスト</span>

テスト