CKTIS / HTML
oninvalid – obravnava neuspešnega preverjanja
Atribut oninvalid vsebuje kodo JavaScript, ki obravnava dogodek invalid, kadar preverjeni kontrolnik ne izpolnjuje omejitev obrazca. Ne zažene se samodejno ob vsakem pritisku tipke.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
oninvalid="JavaScript statements"oninvalid je atribut za obravnavo dogodka invalid. Njegova vrednost je koda JavaScript; znotraj obravnavalnika event označuje dogodek, this pa element. Ustrezna lastnost JavaScript element.oninvalid sprejme funkcijo.
Dogodek se sproži na kontrolniku, ki je predmet preverjanja, ko preverjanje zazna kršitev omejitve, na primer prazno vrednost pri required. Preverjanje lahko poteka med pošiljanjem obrazca ali prek checkValidity() oziroma reportValidity(). Samo tipkanje tega dogodka ne sproži.
invalid se ne širi navzgor: oninvalid na obrazcu ne zajame dogodkov njegovih kontrolnikov. Za skupno obravnavo uporabite addEventListener('invalid', handler, true). Dogodek je mogoče preklicati: event.preventDefault() med interaktivnim preverjanjem prepreči privzeto obvestilo o težavi, vendar ne popravi vrednosti in ne omogoči pošiljanja neveljavnega obrazca. Pri checkValidity() preklic ne spremeni rezultata false.
V primeru prvi checkValidity() pokliče obravnavalnik in vrne false. Ko je dodeljena vrednost OK, drugo preverjanje vrne true brez novega dogodka.
Primeri
<!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>Rezultat
invalid false true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.