HTMLInputElement : propriété selectionDirection

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis novembre 2015.

La propriété selectionDirection de l'interface HTMLInputElement est une chaîne de caractères qui indique la direction dans laquelle l'utilisateur·ice sélectionne le texte.

Dans cet article

Valeur

Une chaîne de caractères. Elle peut avoir l'une des valeurs suivantes :

forward

L'utilisateur·ice étend la sélection vers la fin du texte de l'entrée.

backward

L'utilisateur·ice étend la sélection vers le début du texte de l'entrée.

none

L'utilisateur·ice n'étend pas la sélection.

Note : Sur Windows, la direction indique la position du curseur par rapport à la sélection : une sélection "forward" a le curseur à la fin de la sélection et une sélection "backward" a le curseur au début de la sélection. Windows n'a pas de direction "none".

Note : Sur Mac, la direction indique quelle extrémité de la sélection est affectée lorsque l'utilisateur·ice ajuste la taille de la sélection en utilisant les touches fléchées avec le modificateur Shift : la direction "forward" signifie que l'extrémité de la sélection est modifiée, et la direction "backward" signifie que le début de la sélection est modifié. La direction "none" est la valeur par défaut sur Mac, elle indique qu'aucune direction particulière n'a encore été sélectionnée. L'utilisateur·ice définit la direction implicitement lors du premier ajustement de la sélection, en fonction de la touche fléchée directionnelle utilisée.

Exemples

HTML

html
<label for="selectionDirection">Propriété selectionDirection</label>
<input type="text" id="selectionDirection" value="MDN" />
<p id="direction"></p>

JavaScript

js
const textSelectionDirection = document.querySelector("#selectionDirection");
const pConsole = document.querySelector("#direction");
pConsole.textContent = `Selection direction : ${textSelectionDirection.selectionDirection}`;