CKTIS / HTML
oninvalid — mislukte validatie afhandelen
Het oninvalid-attribuut bevat JavaScript-code die het invalid-event afhandelt wanneer een gecontroleerd besturingselement niet aan de formulierbeperkingen voldoet. Het wordt niet automatisch bij elke toetsaanslag uitgevoerd.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oninvalid="JavaScript statements"oninvalid is het gebeurtenisafhandelingsattribuut voor invalid. De waarde is JavaScript-code; binnen de handler verwijst event naar de gebeurtenis en this naar het element. De bijbehorende JavaScript-eigenschap element.oninvalid accepteert een functie.
De gebeurtenis wordt geactiveerd op een besturingselement dat voor validatie in aanmerking komt wanneer een controle een schending van een beperking vaststelt, bijvoorbeeld een lege waarde bij required. Controles kunnen plaatsvinden bij het verzenden van een formulier of via checkValidity() of reportValidity(). Alleen typen activeert deze gebeurtenis niet.
invalid bubbelt niet: oninvalid op een formulier vangt de gebeurtenissen van de besturingselementen niet op. Gebruik voor gedeelde afhandeling addEventListener('invalid', handler, true). De gebeurtenis kan worden geannuleerd: event.preventDefault() onderdrukt de standaardmelding van het probleem tijdens interactieve validatie, maar herstelt de waarde niet en maakt het niet mogelijk een ongeldig formulier te verzenden. Bij checkValidity() verandert annulering het resultaat false niet.
In het voorbeeld roept de eerste checkValidity() de handler aan en retourneert false. Nadat OK is toegewezen, retourneert de tweede controle true zonder een nieuwe gebeurtenis.
Voorbeelden
<!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>Resultaat
invalid false true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.