CKTIS / HTML
onchange — obsluha události change
Atribut onchange obsahuje JavaScript, který se spustí při události change. U formulářových ovládacích prvků tato událost představuje potvrzenou změnu provedenou uživatelem, nikoli nutně každou úpravu hodnoty.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onchange="JavaScript statements"onchange je obsahový atribut obslužné funkce události change. Jeho hodnota je tělo funkce JavaScript, nikoli URL skriptu. Atribut je dostupný u všech prvků HTML, ale jeho přidáním se samo o sobě nezajistí, že prvek bude událost change generovat.
Okamžik vzniku události závisí na ovládacím prvku. Zaškrtávací políčko vyvolá change, když ho uživatel přepne; textové pole tak obvykle učiní, když se změněná hodnota potvrdí opuštěním pole. K reakci na průběžné úpravy použijte input. Přiřazení do .value nebo .checked v JavaScriptu událost change automaticky nevyvolá.
V kódu atributu odkazuje this na prvek, který událost obsluhuje, a event poskytuje objekt události. Odpovídající vlastností v JavaScriptu je element.onchange; další přiřazení nahradí předchozí funkci tohoto mechanismu. Pomocí element.addEventListener('change', handler) lze registrovat nezávislé posluchače. Zásady Content Security Policy mohou blokovat kód atributu, proto v takovém prostředí použijte povolený skript s addEventListener().
Příklady
<!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>Výsledek
OFF → ON → OFF
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.