CKTIS / HTML
oninvalid – fehlgeschlagene Validierung behandeln
Das Attribut oninvalid enthält JavaScript-Code zur Behandlung des Ereignisses invalid, wenn ein geprüftes Steuerelement die Formularbedingungen nicht erfüllt. Es wird nicht automatisch bei jedem Tastendruck ausgeführt.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oninvalid="JavaScript statements"oninvalid ist das Ereignisbehandlungsattribut für invalid. Sein Wert ist JavaScript-Code; innerhalb des Handlers bezeichnet event das Ereignis und this das Element. Die entsprechende JavaScript-Eigenschaft element.oninvalid kann eine Funktion aufnehmen.
Das Ereignis wird an einem validierungsfähigen Steuerelement ausgelöst, wenn eine Prüfung eine Verletzung der Bedingungen feststellt, zum Beispiel einen leeren Wert bei required. Prüfungen können beim Absenden eines Formulars oder über checkValidity() beziehungsweise reportValidity() stattfinden. Das bloße Eingeben löst dieses Ereignis nicht aus.
invalid wird nicht weitergereicht: Ein oninvalid am Formular fängt die Ereignisse seiner Steuerelemente nicht ab. Für eine gemeinsame Behandlung verwende addEventListener('invalid', handler, true). Das Ereignis kann abgebrochen werden: event.preventDefault() unterdrückt während der interaktiven Validierung die standardmäßige Problemmeldung, behebt aber weder den Wert noch ermöglicht es das Absenden eines ungültigen Formulars. Bei checkValidity() ändert das Abbrechen das Ergebnis false nicht.
Im Beispiel ruft das erste checkValidity() den Handler auf und gibt false zurück. Nach der Zuweisung von OK gibt die zweite Prüfung true zurück, ohne ein weiteres Ereignis auszulösen.
Beispiele
<!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>Ergebnis
invalid false true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.