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.

O método**HTMLInputElement.setSelectionRange()** define as posições inicial e final da seleção atual do texto em um elemento <input>.

Opcionalmente, em navegadores mais novos, você pode especificar a direção na qual a seleção deve ser feita; isso permite a você indicar, por exemplo, que a seleção foi feita como se o usuário tivesse clicado no fim do texto selecionado e arrastado em direção ao início.

Esse método atualiza ao mesmo tempo HTMLInputElement.selectionStart, selectionEnd, and selectionDirection.

Syntax

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

Parameters

selectionStart

The 0-based index of the first selected character.

selectionEnd

The 0-based index of the character after the last selected character.

selectionDirection Optional

A string indicating the direction in which the selection is performed. This string can be "forward" or "backward", or "none" if the direction is unknown or irrelevant.

Example

The following code:

html
<!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>

will produce the following:

example.png

Especificações

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

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
setSelectionRange

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

See also