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.