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é selectionEnd

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é selectionEnd de l'interface HTMLTextAreaElement indique la position de fin de la sélection de texte courante dans un élément HTML <textarea>. Il s'agit d'un nombre représentant l'index final du texte sélectionné. Elle peut être utilisée pour lire ou définir l'index de fin 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 selectionEnd à une valeur inférieure à la valeur actuelle de selectionStart met à jour les propriétés selectionEnd et selectionStart à cette valeur. Si les deux valeurs sont inférieures à 0, 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é selectionEnd à 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 end = textarea.selectionEnd;

Spécifications

Specification
HTML
# dom-textarea/input-selectionend

Compatibilité des navigateurs

Voir aussi