CKTIS / HTML
oninvalid — обработване на неуспешна проверка
Атрибутът oninvalid съдържа JavaScript код, който обработва събитието invalid, когато проверяван контрол не изпълнява ограниченията на формуляра. Не се изпълнява автоматично при всяко натискане на клавиш.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
oninvalid="JavaScript statements"oninvalid е атрибут за обработване на събитието invalid. Стойността му е JavaScript код; в обработчика event обозначава събитието, а this — елемента. Съответното JavaScript свойство element.oninvalid приема функция.
Събитието се задейства върху контрол, подлежащ на проверка, когато проверка установи нарушение на ограничение, например празна стойност при required. Проверките могат да се извършват при изпращане на формуляра или чрез checkValidity() или reportValidity(). Самото писане не задейства това събитие.
invalid не се разпространява нагоре: oninvalid върху формуляр не улавя събитията на неговите контроли. За обща обработка използвайте addEventListener('invalid', handler, true). Събитието може да бъде отменено: event.preventDefault() потиска стандартното съобщаване на проблема по време на интерактивна проверка, но не поправя стойността и не позволява изпращането на невалиден формуляр. При checkValidity() отмяната не променя резултата false.
В примера първото извикване на checkValidity() задейства обработчика и връща false. След задаването на OK втората проверка връща true, без да възниква ново събитие.
Примери
<!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>Резултат
invalid false true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.