CKTIS / HTML
oninvalid — tratar uma validação falhada
O atributo oninvalid contém código JavaScript que trata o evento invalid quando um controlo verificado não cumpre as restrições do formulário. Não é executado automaticamente a cada tecla premida.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
oninvalid="JavaScript statements"oninvalid é o atributo de tratamento do evento invalid. O seu valor é código JavaScript; dentro do processador, event identifica o evento e this identifica o elemento. A propriedade JavaScript correspondente, element.oninvalid, aceita uma função.
O evento é disparado num controlo sujeito a validação quando uma verificação deteta uma violação das restrições, por exemplo, um valor vazio com required. As verificações podem ocorrer durante o envio do formulário ou através de checkValidity() ou reportValidity(). Escrever, por si só, não dispara este evento.
invalid não propaga: o oninvalid de um formulário não capta os eventos dos seus controlos. Para um tratamento comum, utiliza addEventListener('invalid', handler, true). O evento pode ser cancelado: event.preventDefault() suprime a indicação predefinida do problema durante a validação interativa, mas não corrige o valor nem permite enviar um formulário inválido. Com checkValidity(), o cancelamento não altera o resultado false.
No exemplo, o primeiro checkValidity() invoca o processador e devolve false. Depois de atribuir OK, a segunda verificação devolve true sem outro evento.
Exemplos
<!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>Resultado
invalid false true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.