CKTIS / HTML
oninput — obsluha události input
Atribut oninput obsahuje kód JavaScriptu, který se spustí při události input. U textového pole umožňuje reagovat na úpravy uživatele, aniž by bylo nutné čekat, až pole opustí.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
oninput="JavaScript statements"oninput je obsahový atribut obsluhy události input, který je dostupný u všech prvků HTML. Jeho hodnotou je tělo funkce v JavaScriptu, nikoli pouze název události nebo deklarace funkce. Dostupnost atributu neznamená, že každý prvek tyto události sám vytváří.
U textového pole událost input signalizuje úpravy hodnoty provedené uživatelem, například psaní, vkládání nebo mazání textu. Na rozdíl od change nečeká na potvrzení úpravy, k němuž u textového pole obvykle dojde při opuštění pole. Přiřazení hodnoty do value v JavaScriptu událost input automaticky nevyvolá.
V kódu atributu odkazuje this na prvek obsluhující událost a event zpřístupňuje objekt události. Existuje také vlastnost JavaScriptu element.oninput: přiřazením funkce se nahradí dosavadní funkce této obsluhy; přiřazení null ji vypne.
Příklad kopíruje aktuální hodnotu this.value do textContent prvku s výsledkem. Content Security Policy (CSP) může blokovat vložený kód; spuštění příkladu vyžaduje povolení vložených obsluh událostí.
Příklady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oninput example</title>
<label>Text: <input type="text" oninput="document.getElementById('result').textContent = this.value"></label>
<p>Value: <output id="result"></output></p>
</html>Výsledek
Value: abc
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.