Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLTextAreaElement.selectionStart — inizio della selezione

HTMLTextAreaElement.selectionStart legge o imposta l’inizio della selezione in un elemento textarea. L’offset, a partire da zero, conta unità di codice UTF-16 anziché caratteri visibili.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

textarea.selectionStart
textarea.selectionStart = offset

HTMLTextAreaElement.selectionStart è una proprietà scrivibile di un controllo textarea. Insieme a selectionEnd, definisce un intervallo: l’inizio è incluso e la fine è esclusa. Se non è presente una selezione, entrambi i valori indicano il cursore.

Gli offset contano le unità di codice UTF-16 in value: 😀 ne occupa due. Al momento dell’assegnazione, Web IDL converte prima il valore in un intero a 32 bit senza segno. La posizione viene limitata alla fine del testo solo se il valore convertito supera la lunghezza del testo. Ad esempio, assegnare 2 ** 32 imposta l’inizio a 0, perché la conversione restituisce 0. Se l’inizio così ottenuto supera la fine attuale, la fine viene spostata nella stessa posizione e la selezione si riduce a un punto.

Questa è un’API del browser definita dall’HTML Standard, non una funzionalità ECMAScript; la sola versione di Node.js non dimostra che sia supportata. L’esempio usa un controllo non inserito nel documento: è possibile leggerne lo stato di selezione senza renderizzarlo.

Esempi

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);

Risultato

1 3
😀
4 4

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti