Contexto
Uma mensagem como “Ocorreu um erro” não explica o que aconteceu nem como continuar. Mensagens de erro úteis transformam uma falha em orientação: identificam o campo, descrevem o problema e indicam a correção.
Explique o que aconteceu e como corrigir. Identifique o campo ou dado afetado, descreva a regra de forma simples e indique o formato, limite ou valor esperado. Use linguagem neutra, preserve o preenchimento e mantenha a mesma mensagem no campo e no resumo de erros quando ambos existirem.
Porque isso importa?
Mensagens vagas aumentam a incerteza e fazem a pessoa tentar soluções por tentativa e erro. A WCAG exige que erros de entrada sejam identificados e descritos em texto; quando houver uma correção conhecida, recomenda também informar como resolvê-los.
Uma mensagem específica reduz o esforço de recuperação e ajuda a pessoa a corrigir o dado sem abandonar o formulário ou repetir todo o preenchimento.
Quando usar?
- Campo obrigatório não preenchido.
- Formato ou valor incorreto.
- Texto acima ou abaixo do limite.
- Dado incompatível com outra informação.
- Erro detectado após o envio do formulário.
- Falha que a pessoa pode corrigir.
Quando evitar?
- Quando o problema for exclusivamente do serviço.
- Quando a mensagem não indicar o próximo passo.
- Quando bastar repetir o texto “inválido”.
- Quando o texto culpar a pessoa.
- Quando códigos técnicos não ajudarem na correção.
- Quando a mensagem repetir sem necessidade uma instrução já visível.
Recomendações
Faça
- Identifique o campo.
- Descreva o problema.
- Indique a correção.
- Use linguagem simples.
- Preserve os dados.
- Mantenha consistência.
Evite
- Não escreva “Ocorreu um erro”.
- Não use “Campo inválido”.
- Não culpe a pessoa.
- Não exiba códigos técnicos.
- Não dê instruções vagas.
- Não repita o texto sem necessidade.
