HTMLInputElement: setRangeText() メソッド

Baseline 広く利用可能

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

HTMLInputElement.setRangeText() メソッドは、 <input> や <textarea> 要素の中のテキストの範囲を新しい文字列に置き換えます。

構文

js
setRangeText(replacement)
setRangeText(replacement, start)
setRangeText(replacement, start, end)
setRangeText(replacement, start, end, selectMode)

挿入する文字列。

置換する最初の文字を 0 から始まる位置で指定します。既定値は現在の selectionStart の値（ユーザーが現在選択している先頭）です。

置換する最後の文字の次の文字を 0 から始まる位置で指定します。既定値は現在の selectionEnd の値（ユーザーが現在選択している末尾）です。

テキストが置換された後で、選択範囲がどのように設定されるかを定義する文字列です。次の値が利用できます。

なし (undefined)。

この例にあるボタンをクリックすると、テキストボックス内のテキストの一部を置き換えます。新しく挿入されたテキストは、その後で強調（選択）されます。

html
<input
  type="text"
  id="text-box"
  size="30"
  value="このテキストは更新されていません。" />
<button onclick="selectText()">テキストを更新</button>

js
function selectText() {
  const input = document.getElementById("text-box");
  input.focus();
  input.setRangeText("ました", 11, 16, "select");
}

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

このページは役に立ちましたか？

はいいいえ

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