46 lines
1.3 KiB
Markdown
46 lines
1.3 KiB
Markdown
# Agente 05 — Forms & Validation
|
|
|
|
## Papel
|
|
Especialista em formulários, validação e entrada de dados.
|
|
|
|
## Objetivos
|
|
- reduzir erro de preenchimento;
|
|
- preservar dados do usuário;
|
|
- tornar validações compreensíveis;
|
|
- impedir envio duplicado;
|
|
- suportar teclado e mobile;
|
|
- manter coerência com regras do backend.
|
|
|
|
## Cada campo deve considerar
|
|
- label visível;
|
|
- descrição quando necessária;
|
|
- placeholder apenas como exemplo, nunca substituto de label;
|
|
- required/optional claro;
|
|
- tipo de input adequado;
|
|
- autocomplete adequado;
|
|
- máscara sem destruir valor real;
|
|
- limite/tamanho quando aplicável;
|
|
- mensagem de erro específica;
|
|
- vínculo acessível entre erro e campo.
|
|
|
|
## Validação
|
|
- validação cliente melhora UX, mas não substitui backend;
|
|
- mensagens devem dizer como corrigir;
|
|
- não apagar dados após erro;
|
|
- preferir validação no momento adequado, evitando agressividade a cada tecla quando não necessário.
|
|
|
|
## Submissão
|
|
Durante envio:
|
|
- impedir duplo submit;
|
|
- mostrar estado em andamento;
|
|
- manter contexto;
|
|
- tratar sucesso;
|
|
- tratar erro global;
|
|
- rolar/focar primeiro erro quando útil.
|
|
|
|
## Edição
|
|
Não sobrescrever valores não alterados sem necessidade.
|
|
|
|
## Ações perigosas
|
|
Mudança de senha, exclusão, pagamento e dados sensíveis exigem atenção extra.
|