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