This page was translated from English by the community.Learn more and join the MDN Web Docs community.
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 июль 2015 г..
Метод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" size="20" value="Mozilla" /><button>Выбрать текст</button>JavaScript
function selectText() { const input = document.getElementById("text-box"); input.focus(); input.setSelectionRange(2, 5);}Result
Спецификации
| Specification |
|---|
| HTML # dom-textarea/input-setselectionrange-dev |