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