HTMLInputElement.setSelectionRange()
Метод HTMLInputElement.setSelectionRange() устанавливает начальное и конечное положение выделения текста в элементе <input>.
В более новых версиях браузеров, можно дополнительно установить направление выделения текста, что позволит, например, определить, что выделение сделано нажатием и перетаскиванием курсора мыши от конца выделенного текста до начала.
Этот метод позволяет одним вызовом обновить свойства HTMLInputElement.selectionStart, selectionEnd, и selectionDirection.
Синтаксис
inputElement.setSelectionRange(selectionStart, selectionEnd, [optional] selectionDirection);
Параметры
- selectionStart
- Индекс первого выделенного символа.
- selectionEnd
- Индекс символа после последнего выделенного символа.
- selectionDirection Необязательный
- Строка, определяющая направления произведённого выделения. Принимаются значения "forward", "backward" или "none", если направление выделение неизвестно или неважно.
Пример
Следующий код:
<!DOCTYPE html>
<html>
<head>
<meta charset=utf-8>
<title>JS Bin</title>
<script>
function SelectText () {
var input = document.getElementById("mytextbox");
input.focus();
input.setSelectionRange(2,5);
}
</script>
</head>
<body>
<p><input type="text" id="mytextbox" size="20" value="Mozilla"/></p>
<p><button onclick="SelectText()">Select text</button></p>
</body>
</html>
приведёт к следующему результату:
Спецификации
| Спецификация | Статус | Комментарии |
|---|---|---|
| HTML Living Standard Определение 'HTMLInputElement.setSelectionRange' в этой спецификации. |
Живой стандарт | Без изменений |
| HTML 5.1 Определение 'HTMLInputElement.setSelectionRange' в этой спецификации. |
Рекомендация | Без изменений |
| HTML5 Определение 'HTMLInputElement.setSelectionRange' в этой спецификации. |
Рекомендация | Изначальное определение |
Совместимость с браузерами
BCD tables only load in the browser