HTMLInputElement.setSelectionRange()

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

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

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

Синтаксис

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

Параметры

selectionStart

Индекс первого выделенного символа.

selectionEnd

Индекс символа после последнего выделенного символа.

selectionDirection Необязательный

Строка, определяющая направления произведённого выделения. Принимаются значения "forward", "backward" или "none", если направление выделение неизвестно или неважно.

Пример

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

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

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

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

Смотрите также

• <input>
• HTMLInputElement
• Selection