HTMLInputElement.setSelectionRange()

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:

input(text=Mozilla) + bouton sélectionnant le texte entre deux point

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) ? ? ?

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : Goofy, B_M
 Dernière mise à jour par : Goofy,