Mensagens de erro

Como comunicar o que deu errado e como o usuário pode corrigir.

Boas práticas

  • Escrever mensagens específicas, indicando o campo e o problema.
  • Explicar como corrigir, não apenas o que está errado.
  • Exibir a mensagem próxima ao campo com erro.
  • Usar linguagem simples, sem jargão técnico.
  • Resumir os erros no topo do formulário para visão geral.

Anti-padrões

  • Não usar mensagens genéricas como 'Dados inválidos'.
  • Não depender apenas de cor para indicar o erro.
  • Não apagar o que o usuário digitou ao mostrar o erro.

Acessibilidade

  • Associar a mensagem ao campo com aria-describedby.
  • Anunciar o erro para leitores de tela.
  • Garantir contraste e não usar só cor para sinalizar.

Exemplo interativo — ErrorSummary + FormField a11y

ErrorSummary no topo com links âncora para cada campo + FormField com aria-invalid e role="alert". Deixe campos vazios e envie.