CKTIS / HTML
onbeforeinput — zpracování události před úpravou
onbeforeinput je atribut obsluhy události beforeinput, která se týká úprav dat uživatelem. Umožňuje spustit JavaScript před změnou a zrušit výchozí operaci, pokud lze událost zrušit.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onbeforeinput="JavaScript statements"
element.onbeforeinput = function (event) { /* ... */ };onbeforeinput je atribut HTML obsahující kód obsluhy události beforeinput. Je dostupný na všech prvcích HTML; jeho přidání samo o sobě neznamená, že je prvek upravitelný. Odpovídá mu vlastnost JavaScriptu element.onbeforeinput.
V kódu atributu označuje event aktuální událost. Volání event.preventDefault() může zablokovat výchozí operaci pouze tehdy, když má event.cancelable hodnotu true. Nepředpokládejte, že lze tímto způsobem zastavit každou změnu.
Hodnotou atributu je kód JavaScriptu, nikoli název události. Příklad ověřuje obsluhu a zrušení synteticky vyvolané události beforeinput; nesimuluje skutečné psaní. Nezměněná hodnota ABC proto nedokazuje, že byla zablokována nativní úprava.
Příklady
<!doctype html>
<meta charset="utf-8">
<title>onbeforeinput</title>
<input id="editor" value="ABC" onbeforeinput="if (event.cancelable) event.preventDefault()">
<pre id="result"></pre>
<script>
const editor = document.getElementById('editor');
const event = new Event('beforeinput', { bubbles: true, cancelable: true });
const allowed = editor.dispatchEvent(event);
document.getElementById('result').textContent =
`allowed=${allowed}\ndefaultPrevented=${event.defaultPrevented}\nvalue=${editor.value}`;
</script>Výsledek
allowed=false defaultPrevented=true 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.