Guias práticos

Escreva erros de formulário que ajudam as pessoas a se recuperarem

Um erro ajuda apenas quando alguém sabe o que falhou e pode ser retomado sem inserir tudo novamente.

Veja o método

Dois colegas testando um formulário de tablet em uma lista de verificação

Descreva a correção esperada

Conecte cada mensagem ao seu campo e explique as informações necessárias. “Endereço de e-mail incompleto” ajuda mais do que um código técnico. Não culpe o usuário por uma interrupção do servidor ou serviço indisponível.

Explique as regras antes da entrada sempre que possível: formato, comprimento, arquivos aceitos e informações opcionais. Os Guia de formulário de contato Ajuda a reduzir os campos e esclarecer as expectativas.

  • campo e problema identificável.
  • Ação de correção explícita.
  • Restrições explicadas cedo.

Torne o feedback perceptível

Após o envio, mostre um resumo próximo ao início e uma mensagem ao lado de cada campo afetado. Mova o foco de forma previsível e conecte cada campo ao seu erro de tecnologia assistiva. A cor por si só é insuficiente.

Os Tutorial de notificação W3C Dá exemplos de feedback local e geral. Teste o teclado, o leitor de tela, o zoom e as telas estreitas.

  • Mensagens de resumo e campo.
  • associações de erros acessíveis.
  • Foco e contraste testados.

preservar a entrada e a intenção

Mantenha valores válidos após um erro, exceto dados confidenciais que não devem ser exibidos novamente. Um formulário longo deve permitir que alguém seja retomado. Um arquivo rejeitado precisa de uma explicação de formato ou tamanho.

Distinguir erros de validação, atrasos na rede e envio duplicado. Cliques repetidos não devem criar várias solicitações ou pedidos. A confirmação deve dizer se a ação foi realmente registrada.

  • Campos válidos retidos.
  • Falhas de rede tratadas com clareza.
  • Submissões duplicadas controladas.

Teste casos reais

Experimente campos vazios, personagens acentuados, e-mail digitado incorretamente, arquivo de grandes dimensões, sessão expirada e servidor indisponível. Peça a alguém que não esteja familiarizado com o formulário para se recuperar sem ajuda e observe a hesitação.

Após a correção, verifique o e-mail ou a próxima etapa, não apenas a mensagem na tela. O conteúdo de confirmação e erro também precisa ser revisado em todos os idiomas publicados.

  • Erros representativos abordados.
  • viagem completa verificada.
  • Mensagens traduzidas e revisadas.

Documentos de referência

Conteúdo atualizado em 2 de outubro de 2026

Matriz de validação funcional para se adaptar ao projeto

Esses controles propostos usam casos fictícios. Decida qual comportamento é esperado com a equipe, anote o resultado e atribua discrepâncias não resolvidas antes da publicação.

Casos de teste, resultados esperados e evidências úteis
CasoResultado esperadoProva para guardar
Dois campos são inválidos após o envio.Cada erro está associado ao seu campo e o resumo ajuda a localizá-los.Registre o URL, as etapas, o resultado e as evidências datadas.

Perguntas frequentes

Onde devem aparecer os erros de formulário úteis?

Associe uma mensagem precisa ao seu campo e forneça um resumo para vários erros. Explique a correção sem detalhes internos. Preserve entradas úteis e verifique o teclado e a leitura assistida. A cor por si só não consegue identificar o problema.