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

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

JavaScript

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

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 5 дек. 2023 г. by MDN contributors.

View this page on GitHub • Report a problem with this content

HTMLInputElement.setSelectionRange()

In this article

Синтаксис

Параметры

Пример

HTML

JavaScript

Result

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

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

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

Help improve MDN