Erros comuns
Por que importa
Conhecer os anti-padrões mais recorrentes evita retrabalho, reduz bugs de navegação e mantém a experiência coerente em todas as telas. Um catálogo claro acelera revisões e dá segurança para evoluir a DSL sem quebrar fluxos existentes.
Forma canônica (sintaxe mínima)
Separar itens textuais de ações
Por quê: destaca que `` abriga apenas texto, enquanto ações ficam em blocos dedicados como row-end.
Padrões de uso
Destacar ações destrutivas
Quando usar: qualquer operação que remova dados ou interrompa fluxos críticos. Por quê: a variante destrutiva comunica risco e ajuda a prevenir cliques acidentais.
Navigator consistente entre telas irmãs
Quando usar: grupos de telas que compartilham o mesmo menu persistente. Por quê: manter itens idênticos evita destinos ocultos e reduz confusão ao alternar telas.
Overlays com caminho de saída claro
Quando usar: sempre que um drawer ou modal assumir o foco da interação. Por quê: o botão de fechar garante retorno imediato ao contexto original.
Erros comuns (Do/Don’t)
❌ Errado — Links na lista
✅ Correto — Ações fora da lista
Por quê: `` aceita apenas texto; botões e links devem ficar em rows ou navigator.
❌ Errado — Drawer sem saída
✅ Correto — Drawer com retorno
Por quê: oferecer saída explícita evita bloqueios e mantém o fluxo previsível.
❌ Errado — Fechamentos mistos
✅ Correto — Fechamento consistente
Por quê: consistência reduz dúvidas sobre o resultado de cada botão.
Referências cruzadas
Relacionados
Sintaxe básica: reforça regras de estrutura que evitam anti-padrões.Diretrizes de composição: orienta combinações seguras entre blocos.Component Composition: mostra como reutilizar layouts sem introduzir erros.Flow: garante navegação coerente ao aplicar correções.
Composições recomendadas
- Erros comuns + Component Definition → componentes reaproveitados já chegam corrigidos.
- Erros comuns + Navigator → valida menus persistentes antes da publicação.
- Erros comuns + Modal Flow → revê confirmações encadeadas para evitar bloqueios.
Checklist final de revisão
Por quê: padroniza a inspeção e evita que anti-padrões sejam enviados para produção.