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

CKTIS / HTML

novalidate — ignorar a validação ao submeter um formulário

O atributo booleano `novalidate` de um `form` ignora a validação de restrições integrada durante a submissão. Não remove as restrições dos campos nem desativa chamadas explícitas aos métodos de validação.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<form novalidate>...</form>

Adiciona novalidate a um elemento form para ignorar a validação automática de restrições durante a submissão. Por exemplo, um campo vazio com required não impedirá a submissão do formulário.

É um atributo booleano: o que importa é a sua presença, não o texto do valor. As formas válidas são novalidate, novalidate="" e novalidate="novalidate". Escrever novalidate="false" não respeita a sintaxe dos atributos booleanos, mas continua a ativar a omissão da validação. Para restabelecer a verificação automática, remove o atributo ou define a propriedade form.noValidate = false.

Não o confundas com formnovalidate: esse atributo aplica-se a um botão de submissão específico do tipo button ou input. Em contrapartida, novalidate no formulário aplica-se à submissão independentemente do botão utilizado.

As restrições dos campos continuam ativas: checkValidity() continua a verificar a validade e reportValidity() pode apresentar problemas. A validação do lado do cliente não substitui a validação de dados do lado do servidor.

No exemplo, o processador do evento submit impede a submissão efetiva com preventDefault(). Se deixares o campo vazio e clicares em Submit, verás que o evento ocorreu, embora checkValidity() devolva false.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>novalidate demo</title>
<form id="demo" novalidate>
  <label>Name: <input name="name" required></label>
  <button type="submit">Submit</button>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('demo');
  const result = document.getElementById('result');

  form.addEventListener('submit', (event) => {
    event.preventDefault();
    result.textContent = `submit event: yes\ncheckValidity(): ${form.checkValidity()}`;
  });
</script>
</html>

Resultado

submit event: yes
checkValidity(): false

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