CKTIS / HTML
oninvalid – spracovanie neúspešnej validácie
Atribút oninvalid obsahuje JavaScriptový kód, ktorý spracuje udalosť invalid, keď kontrolovaný prvok nespĺňa obmedzenia formulára. Nespúšťa sa automaticky pri každom stlačení klávesu.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oninvalid="JavaScript statements"oninvalid je atribút obsluhy udalosti invalid. Jeho hodnotou je JavaScriptový kód; v obslužnej funkcii označuje event udalosť a this prvok. Zodpovedajúca JavaScriptová vlastnosť element.oninvalid prijíma funkciu.
Udalosť sa vyvolá na prvku, ktorý podlieha validácii, keď kontrola zistí porušenie obmedzenia, napríklad prázdnu hodnotu pri použití required. Kontroly môžu prebehnúť pri odoslaní formulára alebo prostredníctvom checkValidity() či reportValidity(). Samotné písanie túto udalosť nevyvolá.
invalid sa nešíri smerom nahor: oninvalid na formulári nezachytí udalosti jeho ovládacích prvkov. Na spoločné spracovanie použite addEventListener('invalid', handler, true). Udalosť možno zrušiť: event.preventDefault() potlačí predvolené oznámenie problému počas interaktívnej validácie, ale neopraví hodnotu ani neumožní odoslať neplatný formulár. Pri checkValidity() zrušenie nemení výsledok false.
V príklade prvé volanie checkValidity() vyvolá obslužnú funkciu a vráti false. Po priradení hodnoty OK vráti druhá kontrola true bez ďalšej udalosti.
Príklady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oninvalid example</title>
<label>Required value <input id="field" required oninvalid="document.getElementById('result').textContent += event.type + '\n'"></label>
<pre id="result"></pre>
<script>
const field = document.getElementById('field');
const result = document.getElementById('result');
const first = field.checkValidity();
result.textContent += String(first) + '\n';
field.value = 'OK';
result.textContent += String(field.checkValidity());
</script>
</html>Výsledok
invalid false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.