Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLTextAreaElement.selectionEnd — fine della selezione

HTMLTextAreaElement.selectionEnd consente di leggere o impostare il limite finale di una selezione in un textarea. È un offset a partire da zero, misurato in unità di codice UTF-16; la posizione finale non è inclusa nella selezione.

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.selectionEnd
textarea.selectionEnd = end

HTMLTextAreaElement.selectionEnd è una proprietà di lettura e scrittura. Indica la posizione subito dopo il testo selezionato in textarea.value. selectionStart e selectionEnd descrivono un inizio incluso e una fine esclusa. Quando non c’è una selezione, entrambi i valori indicano la posizione del cursore.

Gli offset contano unità di codice UTF-16, non caratteri visibili: alcune emoji occupano due unità. Per textarea, l’API usa il valore con i terminatori di riga normalizzati, non il testo grezzo contenente CR.

L’assegnazione modifica il limite della selezione, non il testo. Web IDL converte prima il valore assegnato nel tipo unsigned long. Se il valore ottenuto supera la lunghezza del testo, viene limitato a tale lunghezza. Ad esempio, 2 ** 32 viene convertito in 0, quindi assegnarlo imposta la fine a 0, non alla lunghezza del testo di un textarea non vuoto. Se la nuova fine precede selectionStart, anche l’inizio viene spostato alla nuova fine e la selezione si annulla. Usa setSelectionRange(start, end) per impostare insieme entrambi i limiti.

Lo stato della selezione esiste anche per un elemento non visualizzato; perciò l’esempio non aggiunge il controllo al documento. Questa è un’API del browser definita dall’HTML Standard, non una funzionalità del linguaggio ECMAScript; la presenza di Node 24 non ne dimostra la disponibilità.

Esempi

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

Risultato

5
Hello
Hel

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