CKTIS / JavaScript
HTMLTextAreaElement.selectionStart — début de la sélection
HTMLTextAreaElement.selectionStart lit ou définit le début de la sélection dans un élément textarea. Son décalage, compté à partir de zéro, correspond aux unités de code UTF-16 et non aux caractères visibles.
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.selectionStart
textarea.selectionStart = offsetHTMLTextAreaElement.selectionStart est une propriété modifiable d’un contrôle textarea. Avec selectionEnd, elle définit une plage : le début est inclus et la fin est exclue. En l’absence de sélection, les deux valeurs indiquent la position du curseur.
Les décalages comptent les unités de code UTF-16 dans value : 😀 en occupe deux. Lors de l’affectation, Web IDL convertit d’abord la valeur en un entier non signé sur 32 bits. La position n’est ramenée à la fin du texte que si la valeur obtenue dépasse la longueur du texte. Par exemple, affecter 2 ** 32 place le début à 0, car la conversion donne 0. Si le début ainsi obtenu se trouve après la fin actuelle, la fin est déplacée à la même position, ce qui réduit la sélection à un point.
Il s’agit d’une API de navigateur issue du HTML Standard, et non d’une fonctionnalité ECMAScript ; la seule version de Node.js ne permet pas d’établir sa prise en charge. L’exemple utilise un contrôle détaché : son état de sélection peut être lu sans rendu.
Exemples
const textarea = document.createElement('textarea');
textarea.value = 'A😀BC';
textarea.setSelectionRange(1, 3);
console.log(textarea.selectionStart, textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionStart = 4;
console.log(textarea.selectionStart, textarea.selectionEnd);Résultat
1 3 😀 4 4
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.