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

CKTIS / HTML

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

O atributo booleano `formnovalidate` permite que um botão de submissão ignore a validação automática de restrições do formulário. Pode ser útil, por exemplo, para guardar um rascunho incompleto sem alterar os requisitos dos campos.

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

Sintaxe

formnovalidate | formnovalidate="" | formnovalidate="formnovalidate"

formnovalidate ignora a validação automática de restrições quando o formulário é submetido através desse botão. Aplica-se aos elementos button que funcionam como botões de submissão. Não é necessário indicar explicitamente type="submit": se um elemento button sem o atributo type funcionar como botão de submissão, formnovalidate também se aplica. O atributo aplica-se ainda aos elementos input com type="submit" ou type="image". Não se destina a um campo de texto normal nem a um botão com type="button".

É um atributo booleano: a sua presença ativa a omissão da validação. As formas válidas são formnovalidate, formnovalidate="" e formnovalidate="formnovalidate". Escrever formnovalidate="false" não está em conformidade e o atributo continua presente; remove o atributo para desativar esta funcionalidade.

novalidate no formulário ignora a validação de todo o formulário, enquanto formnovalidate se aplica à submissão através de um botão específico. Um botão sem formnovalidate não pode repor a validação se o formulário tiver novalidate.

Ignorar a validação não torna válidos os campos inválidos. Uma chamada explícita a checkValidity() continua a verificar as restrições. No exemplo, o processador submit impede a submissão efetiva e apresenta o resultado dessa verificação. Valida também os dados no servidor: a validação no navegador não é uma barreira de segurança.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>formnovalidate demo</title>
<form id="editor">
  <label>Title <input name="title" required></label>
  <button type="submit" value="publish">Publish</button>
  <button type="submit" value="draft" formnovalidate>Save draft</button>
</form>
<pre id="result" aria-live="polite">No submission</pre>
<script>
  const editor = document.getElementById('editor');
  const result = document.getElementById('result');
  editor.addEventListener('submit', (event) => {
    event.preventDefault();
    result.textContent = event.submitter.value
      + ': valid=' + editor.checkValidity();
  });
</script>
</html>

Resultado

draft: valid=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