Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onchange — gestire un evento change

L’attributo onchange contiene codice JavaScript eseguito quando si verifica un evento change. Nei controlli dei moduli, questo evento rappresenta una modifica confermata dall’utente, non necessariamente ogni modifica del valore.

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

Sintassi

onchange="JavaScript statements"

onchange è un attributo di contenuto per la gestione dell’evento change. Il suo valore è il corpo di una funzione JavaScript, non l’URL di uno script. L’attributo è disponibile su tutti gli elementi HTML, ma la sua semplice aggiunta non fa sì che un elemento generi change.

Il momento in cui si verifica l’evento dipende dal controllo. Una casella di controllo emette change quando l’utente la attiva o la disattiva; un campo di testo in genere lo fa quando il valore modificato viene confermato uscendo dal campo. Usa input per reagire alle modifiche in corso. Assegnare .value o .checked in JavaScript non emette automaticamente change.

Nel codice dell’attributo, this fa riferimento all’elemento che gestisce l’evento, mentre event fornisce l’oggetto evento. L’equivalente JavaScript è la proprietà element.onchange; una nuova assegnazione sostituisce la funzione precedente di questo meccanismo. element.addEventListener('change', handler) consente di registrare listener indipendenti. Una Content Security Policy può bloccare il codice degli attributi; in questo caso, usa uno script consentito con addEventListener().

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onchange example</title>
<label>
  <input type="checkbox" onchange="document.getElementById('state').textContent = this.checked ? 'ON' : 'OFF'">
  Enabled
</label>
<p id="state" role="status">OFF</p>
</html>

Risultato

OFF → ON → OFF

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