CKTIS / HTML
oninvalid — obsługa nieudanej walidacji
Atrybut oninvalid zawiera kod JavaScript obsługujący zdarzenie invalid, gdy sprawdzana kontrolka nie spełnia ograniczeń formularza. Nie uruchamia się automatycznie przy każdym naciśnięciu klawisza.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
oninvalid="JavaScript statements"oninvalid to atrybut obsługi zdarzenia invalid. Jego wartością jest kod JavaScript; wewnątrz procedury event oznacza zdarzenie, a this — element. Odpowiada mu właściwość JavaScript element.oninvalid, której można przypisać funkcję.
Zdarzenie jest wywoływane na kontrolce objętej walidacją, gdy sprawdzenie wykryje naruszenie ograniczeń, np. pustą wartość przy required. Sprawdzenie może nastąpić podczas wysyłania formularza albo przez checkValidity() lub reportValidity(). Samo wpisywanie tekstu nie wywołuje tego zdarzenia.
invalid nie bąbelkuje: oninvalid na formularzu nie przechwytuje zdarzeń jego kontrolek. Do wspólnej obsługi użyj addEventListener('invalid', handler, true). Zdarzenie można anulować: event.preventDefault() wyłącza domyślne zgłaszanie problemu podczas interaktywnej walidacji, ale nie naprawia wartości ani nie umożliwia wysłania niepoprawnego formularza. Przy checkValidity() anulowanie nie zmienia wyniku false.
W przykładzie pierwsze checkValidity() wywołuje procedurę i zwraca false. Po przypisaniu OK drugie sprawdzenie zwraca true bez kolejnego zdarzenia.
Przykłady
<!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>Wynik
invalid false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.