Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onselect — gestire la selezione del testo

L’attributo onselect definisce il codice JavaScript eseguito quando si verifica un evento select, in genere quando si seleziona del testo in un controllo input o textarea. Non rileva la selezione di opzioni in un elemento select.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

onselect="JavaScript statements"
element.onselect = function (event) { /* handler */ }

onselect è un attributo gestore di eventi per l’evento select. È disponibile su tutti gli elementi HTML, ma aggiungerlo non fa sì che un elemento generi tali eventi. Il suo uso tipico è reagire alla selezione del testo nei controlli input che la supportano e in textarea; la selezione può anche essere modificata programmaticamente.

Il valore dell’attributo è codice JavaScript, non un valore booleano né semplicemente il nome di una funzione. In un gestore inline, event rappresenta l’evento e this si riferisce all’elemento che lo gestisce. I limiti della selezione si leggono tramite selectionStart e selectionEnd; il secondo indice non è incluso nella sottostringa selezionata.

La proprietà JavaScript corrispondente, element.onselect, accetta una funzione; assegnarne un’altra sostituisce il gestore precedente in quella posizione. Un’alternativa è addEventListener('select', handler). Non confondere l’evento select con l’elemento select: usa input o change per reagire al cambiamento dell’opzione selezionata.

L’esempio imposta l’intervallo dall’indice 1 al 5 in Hello. Dopo la gestione dell’evento, il risultato è Selected: ello. JavaScript e i gestori di eventi inline devono essere abilitati; una Content Security Policy può bloccare i gestori inline.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>onselect demo</title>
<label>Text: <input id="text" type="text" value="Hello" onselect="document.getElementById('result').textContent = this.value.slice(this.selectionStart, this.selectionEnd)"></label>
<p>Selected: <output id="result"></output></p>
<script>
  document.getElementById('text').setSelectionRange(1, 5);
</script>

Risultato

Selected: ello

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