HTMLInputElement: метод setRangeText()

Базовая поддержка Широко доступен

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Метод HTMLInputElement.setRangeText() заменяет фрагмент текста в элементе <input> или <textarea> новой строкой.

Синтаксис

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

Параметры

replacement

Строка для вставки.

start Необязательно

Индекс первой заменяемой символа (с нуля). По умолчанию используется текущее значение selectionStart (начало текущего выделения пользователя).

end Необязательно

Индекс символа после последнего заменяемого символа (с нуля). По умолчанию используется текущее значение selectionEnd (конец текущего выделения пользователя).

selectMode Необязательно

Строка, определяющая, как установить выделение после замены текста. Возможные значения:

"select" выделяет только что вставленный текст.
"start" переносит выделение перед вставленным текстом.
"end" переносит выделение после вставленного текста.
"preserve" пытается сохранить предыдущее выделение. Это значение по умолчанию.

Возвращаемое значение

None (undefined).

Примеры

Нажмите на кнопку в этом примере, чтобы заменить часть текста в текстовом поле. Вставленный текст будет выделен (выбран) после замены.

HTML

<input
  type="text"
  id="text-box"
  size="30"
  value="This text has NOT been updated." />
<button onclick="selectText()">Update text</button>

JavaScript

function selectText() {
  const input = document.getElementById("text-box");
  input.focus();
  input.setRangeText("ALREADY", 14, 17, "select");
}

Результат

Спецификации

Спецификация
HTML # dom-textarea/input-setrangetext-dev

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`setRangeText`	24	79	27	15	7	25	27	14	7	1.5	4.4

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setRangeText