Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes