Guia prático de trabalho
Como tornar os erros do formulário claros e acessíveis
Um erro acessível identifica o campo, explica como corrigir o problema e permite continuar sem perder respostas válidas. Combine texto visível com associações programáticas e acesso por teclado; uma borda vermelha, sozinha, não explica o que fazer.
Substitua mensagens vagas por instruções de correção
| Falha | Detalhes |
|---|---|
| Sem forma de contato | Texto pouco útil: Formulário inválido Instrução útil: Informe email ou telefone para podermos responder. |
| Arquivo grande demais | Texto pouco útil: Envio falhou Instrução útil: Escolha um arquivo dentro do limite de tamanho informado. |
| Falha de rede | Texto pouco útil: Ocorreu um erro Instrução útil: A solicitação não foi confirmada. Mantenha a página aberta e tente novamente. |
Fontes: W3C WAI — Form notifications.
Teste a recuperação completa, não apenas o texto
A W3C WAI descreve notificações claras e orientação para corrigir erros. Use este registro com o formulário real, teclado e leitor de tela. Os resultados seguintes são objetivos de aceitação, não testes já feitos no seu site.
- Enviar com campos obrigatórios vazios: o resumo explica os problemas e permite chegar aos campos.
- Corrigir um campo: o erro desaparece sem apagar outras respostas nem deslocar o foco inesperadamente.
- Provocar uma falha inofensiva do servidor: não aparece confirmação de sucesso e a repetição não duplica solicitações.
Guarde uma linha de evidência por problema
Registre campo, entrada, anúncio esperado, foco observado, valores preservados e próxima ação. “Anexo rejeitado; descrição preservada; campo anunciado; pessoa pode substituir o arquivo” é evidência útil. “Parece acessível” não é. Verifique os erros em cada idioma e confirme que o sucesso descreve o que aconteceu, sem prometer prazos impossíveis.