Eventos de Formulário: input, change, submit e Validação Assíncrona
Formulários são o principal ponto de contato e conversão de qualquer aplicação web — desde simples telas de login e checkout de e-commerce até cadastros de dados complexos em sistemas ERP. Dominar os eventos de formulário no DOM é o que separa interfaces lentas e frustrantes daquelas que oferecem validação fluida em tempo real, máscaras instantâneas e prevenção de envios duplicados.
Nesta lição sênior, você compreenderá as diferenças operacionais exatas entre os eventos input e change, dominará a interceptação e serialização de dados no evento submit através da interface nativa FormData, explorará a dupla de eventos de foco (focusin vs focusout) e aprenderá a utilizar a poderosa Constraint Validation API do navegador para criar validações acessíveis e de alta performance sem depender de bibliotecas externas pesadas.
📑 Índice do Conteúdo
1. A Batalha: `input` vs `change`
Embora ambos notifiquem alterações de valor em campos de entrada, eles foram projetados para momentos completamente distintos da experiência do usuário:
| Característica | Evento input |
Evento change |
|---|---|---|
| Momento de Disparo | Imediato: a cada tecla digitada, caractere colado (Ctrl+V), corte (Ctrl+X) ou fala por voz. | Diferido: disparado apenas quando o elemento perde o foco (evento blur) e seu valor final for diferente do inicial. |
Comportamento em <select> |
Disparado ao selecionar uma nova opção. | Disparado ao confirmar a nova opção selecionada. |
| Comportamento em Checkbox/Radio | Dispara imediatamente ao alternar o estado. | Dispara imediatamente ao alternar o estado. |
| Uso Recomendado | Máscaras dinâmicas (CPF/Telefone), medidores de força de senha, contadores de caracteres e buscas instantâneas. | Validações completas de regras de negócio pesadas, cálculos de frete e salvamento automático de rascunhos. |
2. O Evento `submit` e a Interface Moderna `FormData`
O envio tradicional de formulários HTML acarreta o recarregamento síncrono da página inteira pelo navegador. Em Single Page Applications (SPAs) e sistemas modernos com AJAX/Fetch, o padrão obrigatório é interceptar o evento submit no elemento <form>, cancelar a ação padrão com event.preventDefault() e extrair todos os valores em uma única linha com a interface FormData:
const userForm = document.querySelector('#cadastro-form');
userForm.addEventListener('submit', async (event) => {
// 1. Impede o recarregamento da página
event.preventDefault();
// 2. Extrai automaticamente todos os campos com o atributo 'name'
const formData = new FormData(userForm);
// 3. Converte os pares chave/valor em um objeto JavaScript limpo
const payload = Object.fromEntries(formData.entries());
try {
desabilitarBotaoEnvio(true);
const resposta = await fetch('/api/usuarios', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
});
if (resposta.ok) {
exibirToastSucesso('Cadastro concluído com sucesso!');
userForm.reset(); // Restaura o formulário para o estado inicial
}
} catch (erro) {
console.error('Falha de rede:', erro);
} finally {
desabilitarBotaoEnvio(false);
}
});
3. Delegação de Eventos de Foco: `focusin` e `focusout`
Os eventos clássicos focus e blur possuem uma limitação severa: eles não borbulham na árvore DOM. Se você tiver um formulário com 30 campos e desejar aplicar um efeito visual no container pai quando qualquer campo estiver focado, você não conseguirá escutar focus no elemento <form>.
A especificação DOM Level 3 Events resolveu isso criando focusin e focusout. Eles são funcionalmente idênticos, com uma enorme vantagem arquitetural: eles borbulham normalmente, permitindo delegar o controle de foco de todos os inputs em um único ouvinte no formulário pai.
4. Validação Nativa com a Constraint Validation API
Antes de implementar validações manuais com expressões regulares complexas, aproveite a robusta API nativa do navegador embutida em cada elemento de formulário:
input.checkValidity(): Retornatruese o valor atender a todos os atributos HTML5 (required,minlength,pattern,type="email"). Retornafalsee dispara o eventoinvalidse falhar.input.validity: Objeto que detalha o motivo exato da falha:validity.valueMissing: Campo obrigatório vazio.validity.typeMismatch: Email ou URL mal formatada.validity.patternMismatch: Não satisfez a regex depattern.validity.tooShort/validity.tooLong: Desrespeito a comprimentos mínimos/máximos.
input.setCustomValidity(mensagem): Define uma mensagem de erro customizada em português. Se você passar uma string vazia (""), o campo volta a ser considerado válido.
5. Laboratório Interativo no Playground IDE
No laboratório prático desta lição, você operará um formulário de cadastro completo contendo: campo de nome com contador dinâmico de caracteres via input, campo de senha com medidor visual de força em tempo real, seletor de plano reagindo a change, validação nativa com checkValidity() e interceptação de submit com geração de payload JSON via FormData exibido em um console de depuração em tempo real.
Aplique o que você aprendeu nesta lição
Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground Web Online
Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.
⚡ Codificar no Playground IDE