HTMLInputElement: setRangeText() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 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");
}

Specification

Enable JavaScript to view this browser compatibility table.

Was this page helpful to you?

Yes No

This page was last modified on 2025年6月24日 by MDN contributors.