La métode HTMLInputElement.setSelectionRange() définit la position de début et de fin de la sélection de texte d'un élément <input>. De façon facultative, dans les nouvelles versions des navigateurs, il est possible de spécifier la direction dans laquelle la sélection a été faite ; cela permet d'indiquer, par exemple, que la sélection a été réalisée par l'utilisateur en partant de la fin de la sélection pour aller vers le début.
Syntaxe
inputElement.setSelectionRange(selectionStart, selectionEnd, [optional] selectionDirection);
Paramètres
- selectionStart
- L'index du premier caractère selectionné.
- selectionEnd
- L'index du caractère après le dernier caractère selectionné.
- selectionDirection Facultatif
- Un chaine de caractères indiquant la direction dans laquelle la sélection a été réalisée. Cela peut être "forward" ou "backward", ou "none" si la direction est inconnue ou sans importance.
Exemple
Le code suivant:
<!DOCTYPE html>
<html>
<head>
<meta charset=utf-8 />
<title>JS Bin</title>
<script>
function SelectText(){
var input = document.getElementById("mytextbox"),
from = document.getElementById("from"),
to = document.getElementById("to");
input.focus();
input.setSelectionRange(from.value, to.value);
}
</script>
</head>
<body>
<p><input type="text" id="mytextbox" size="20" value="Mozilla" /></p>
<p>
<button onclick="SelectText()">Sélectionner le texte</button>
de <input type="number" id="from" value="2" />
à <input type="number" id="to" value="5" />
</p>
</body>
</html>
Produira:
Compatibilité entre les navigateurs
| Fonctionnalités | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support basique | 1.0 | 1.0 (1.7 ou moins) | 9 | 8.00 | At least 3 |
selectionDirection |
15 | 8.0 (8.0) | Pas de support | Pas de support | Pas de support |
| Fonctionnalités | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Support basique | ? | ? | ? | ? | ? |
selectionDirection |
? | 8.0 (8.0) | ? | ? | ? |