Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje