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

CKTIS / JavaScript

Formulários e validade

Usa `input` para reagir a alterações num campo e `submit` para tratar a submissão do formulário após a validação normal. `HTMLFormElement` também disponibiliza métodos para verificar explicitamente a validade do formulário.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();

HTMLFormElement é a interface do DOM do navegador que representa um elemento form. A propriedade form.elements dá acesso aos controlos associados ao formulário. É uma API Web, não faz parte da linguagem ECMAScript.

Escuta o evento input para reagir a alterações feitas pelo utilizador, por exemplo, para atualizar uma indicação enquanto escreve. Atribuir um valor a field.value em JavaScript não desencadeia, por si só, o evento input. O atributo required faz com que um campo de texto vazio seja inválido. form.checkValidity() devolve o resultado como um valor booleano. form.reportValidity() também devolve um valor booleano e apresenta os erros de validação ao utilizador, a menos que o evento invalid do controlo em causa seja cancelado. Cancelar esse evento não altera o resultado da validação: o método devolve false sem apresentar um erro para esse controlo.

Numa tentativa normal de submissão, o navegador verifica primeiro as restrições. Se um campo for inválido, o navegador bloqueia a submissão e o evento submit não é desencadeado. Se a validação for bem-sucedida, submit é desencadeado no formulário, e não no botão. Chamar event.preventDefault() no manipulador do evento cancela a submissão predefinida.

Usa form.requestSubmit() para iniciar o mesmo processo a partir do código. Chamar diretamente form.submit() ignora tanto a validação como o evento submit. A validação no navegador ajuda os utilizadores a corrigir os dados introduzidos, mas não substitui a validação no servidor.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
  <label>Name <input name="displayName" required></label>
  <button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.querySelector('#profile');
  const field = form.elements.namedItem('displayName');
  const log = document.querySelector('#log');
  const append = (line) => { log.textContent += line + '\n'; };

  field.addEventListener('input', () => {
    append(`input: ${form.checkValidity()}`);
  });
  form.addEventListener('submit', (event) => {
    event.preventDefault();
    append(`submit: ${field.value}`);
  });

  append(`initial: ${form.checkValidity()}`);
</script>

Resultado

initial: false
input: true
submit: A

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