HTMLInputElement.setSelectionRange()

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 Standard
# dom-textarea/input-setselectionrange-dev

Compatibilidade com navegadores

BCD tables only load in the browser

See also