CKTIS / HTML
onchange — obravnavanje dogodka change
Atribut onchange vsebuje JavaScript, ki se izvede ob dogodku change. Pri kontrolnikih obrazca ta dogodek pomeni, da je uporabnik spremembo potrdil, ne pa nujno vsakega urejanja vrednosti.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onchange="JavaScript statements"onchange je vsebinski atribut za obravnavo dogodka change. Njegova vrednost je telo funkcije JavaScript, ne URL skripta. Atribut je na voljo pri vseh elementih HTML, vendar njegova dodana prisotnost sama po sebi ne povzroči, da element sproži change.
Čas dogodka je odvisen od kontrolnika. Potrditveno polje sproži change, ko ga uporabnik preklopi; besedilno polje to običajno stori, ko uporabnik potrdi spremenjeno vrednost tako, da zapusti polje. Za odzivanje na sprotno urejanje uporabite input. Dodelitev vrednosti .value ali .checked v JavaScriptu ne sproži samodejno dogodka change.
V kodi atributa se this nanaša na element, ki obravnava dogodek, event pa zagotavlja objekt dogodka. Ustreznik v JavaScriptu je lastnost element.onchange; nova dodelitev zamenja prejšnjo funkcijo tega mehanizma. Z element.addEventListener('change', handler) lahko registrirate neodvisne poslušalce. Politika Content Security Policy lahko blokira kodo atributov, zato v takem okolju uporabite dovoljeni skript z addEventListener().
Primeri
<!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>Rezultat
OFF → ON → OFF
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.