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:

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

Specifications

Browser compatibility

BCD tables only load in the browser

See also