CKTIS / JavaScript
HTMLTextAreaElement.selectionEnd — fin de la sélection
HTMLTextAreaElement.selectionEnd permet de lire ou de définir la limite de fin d’une sélection dans un textarea. Il s’agit d’un décalage commençant à zéro, mesuré en unités de code UTF-16 ; la position de fin n’est pas incluse dans la sélection.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
textarea.selectionEnd
textarea.selectionEnd = endHTMLTextAreaElement.selectionEnd est une propriété accessible en lecture et en écriture. Elle indique la position juste après le texte sélectionné dans textarea.value. selectionStart et selectionEnd définissent un début inclus et une fin exclue. En l’absence de sélection, les deux valeurs correspondent à la position du curseur.
Les décalages comptent les unités de code UTF-16, et non les caractères visibles : certains emoji occupent deux unités. Pour textarea, l’API utilise la valeur dont les fins de ligne sont normalisées, plutôt que le texte brut contenant des CR.
Une affectation modifie la limite de la sélection, pas le texte. Web IDL convertit d’abord la valeur affectée en unsigned long. Si la valeur obtenue dépasse la longueur du texte, elle est ramenée à cette longueur. Par exemple, 2 ** 32 donne 0 après conversion : affecter cette valeur place donc la fin à 0, et non à la longueur du texte d’un textarea non vide. Si la nouvelle fin précède selectionStart, le début est lui aussi déplacé jusqu’à cette nouvelle fin, ce qui réduit la sélection à zéro. Utilisez setSelectionRange(start, end) pour définir les deux limites à la fois.
L’état de la sélection existe même pour un élément qui n’est pas rendu ; l’exemple n’ajoute donc pas le contrôle au document. Il s’agit d’une API de navigateur définie par le HTML Standard, et non d’une fonctionnalité du langage ECMAScript ; la présence de Node 24 ne garantit pas sa disponibilité.
Exemples
const textarea = document.createElement('textarea');
textarea.value = 'Hello world';
textarea.setSelectionRange(0, 5);
console.log(textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionEnd = 3;
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));Résultat
5 Hello Hel
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.