HTMLInputElement.setSelectionRange()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Метод HTMLInputElement.setSelectionRange() устанавливает начальное и конечное положение выделения текста в элементе <input>.

В более новых версиях браузеров, можно дополнительно установить направление выделения текста, что позволит, например, определить, что выделение сделано нажатием и перетаскиванием курсора мыши от конца выделенного текста до начала.

Этот метод позволяет одним вызовом обновить свойства HTMLInputElement.selectionStart, selectionEnd, и selectionDirection.

Синтаксис

inputElement.setSelectionRange(selectionStart, selectionEnd, [optional] selectionDirection);

Параметры

selectionStart: Индекс первого выделенного символа.
selectionEnd: Индекс символа после последнего выделенного символа.
selectionDirection Необязательный: Строка, определяющая направления произведённого выделения. Принимаются значения "forward", "backward" или "none", если направление выделение неизвестно или неважно.

Пример

Кликните на кнопку, чтобы выбрать третий, четвёртый и пятый символы в текстовом поле ("zil" в слове "Mozilla").

HTML

html

<input type="text" id="text-box" size="20" value="Mozilla" />
<button onclick="selectText()">Выбрать текст</button>

JavaScript

function selectText() {
  const input = document.getElementById("text-box");
  input.focus();
  input.setSelectionRange(2, 5);
}

Result

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

Specification
HTML # dom-textarea/input-setselectionrange-dev