Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLTextAreaElement : propriété selectionStart

Baseline Widely available

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

La propriété selectionStart de l'interface HTMLTextAreaElement indique la position de début de la sélection de texte courante dans un élément HTML <textarea>. Il s'agit d'un nombre représentant l'index de début du texte sélectionné. Elle peut être utilisée pour lire ou définir l'index de début du texte sélectionné dans le <textarea>.

Lorsqu'aucun texte n'est sélectionné, la valeur de selectionStart et de selectionEnd correspond à la position du curseur à l'intérieur de l'élément <textarea>.

Définir selectionStart à une valeur supérieure à la valeur actuelle de selectionEnd met à jour les propriétés selectionStart et selectionEnd à cette valeur. Si cette valeur est supérieure ou égale à textLength, les deux propriétés sont définies à la valeur de la propriété textLength.

La valeur de la propriété peut être lue et définie sans que le <textarea> ait le focus, mais l'élément doit avoir le focus pour que le pseudo-élément CSS ::selection corresponde au texte sélectionné.

Définir la propriété selectionStart à une nouvelle valeur déclenche les évènements selectionchange et select.

Valeur

Un nombre qui n'est pas négatif.

Exemples

js
const textarea = document.getElementById("text-box");
const start = textarea.selectionStart;

Spécifications

Specification
HTML
# dom-textarea/input-selectionstart

Compatibilité des navigateurs

Voir aussi