Layout que comunica estrutura
O layout comunica antes mesmo de uma única palavra ser lida: posição, espaçamento e alinhamento carregam hierarquia por si só, e espaço generoso vence decoração. Um bom layout também sobrevive a estresse: redimensione-o, traduza-o, espelhe-o para RTL, e ele deve continuar coeso. Aplique estes princípios ao construir ou revisar código de UI, e expresse cada mudança no sistema de estilo existente do projeto (Tailwind, CSS puro, CSS-in-JS); nunca introduza uma segunda abordagem de estilo.
Tamanhos de áreas de toque e comportamento de foco são cobertos pela skill better-accessibility; polimento visual (raio, sombras, animação) pela skill better-ui; comprimento de linha e espaçamento de texto pela skill better-typography.
Trate os valores numéricos abaixo como pontos de partida para interfaces sem um sistema de densidade ou espaçamento estabelecido. Preserve a estrutura deliberada da plataforma, ferramentas profissionais compactas e tokens do projeto quando permanecerem utilizáveis sob testes de estresse de área de toque, zoom, localização e viewport.
Referência Rápida
| Categoria | Quando Usar |
|---|---|
| Agrupamento e Alinhamento | Espaço vs separadores, bordas de alinhamento, propriedades lógicas, ordenação por importância |
| Espaçamento e Adaptabilidade | Espaçamento entre alvos, margens de layout, divulgação progressiva, conteúdo full-bleed, breakpoints, crescimento i18n |
Princípios Centrais
1. Agrupe com Espaço, Não com Linhas
O espaço negativo é a principal ferramenta de agrupamento; fundos com forma vêm em segundo; linhas separadoras por último, apenas onde o espaço sozinho não consegue carregar a estrutura. O espaço entre grupos deve ser pelo menos 2× o espaço dentro de um grupo (8px intra-grupo → 16px+ inter-grupo), senão o agrupamento parece ruído.
2. Mantenha Controles Distintos do Conteúdo
Elementos interativos devem parecer interativos: uma forma de fundo, uma borda ou uma zona de posicionamento consistente. Nunca estilize um controle de forma idêntica ao texto estático adjacente.
3. Alinhe a Bordas Compartilhadas
Escolha bordas de alinhamento e mantenha-se fiel a elas; cada borda fora do padrão parece ruído. Use um passo de espaçamento do projeto para cada nível de subordinação (16px é um padrão útil). Use propriedades lógicas (padding-inline-start, margin-inline-end) para layout dependente de direção; reserve left/right físicos apenas para geometria verdadeiramente física.
4. Ordene por Importância
O conteúdo mais importante fica próximo ao topo e à borda inicial; a ordem de leitura flui de cima para baixo, da borda inicial para a final. Pense em inicial/final, não esquerda/direita.
5. Sugira Conteúdo Oculto
A divulgação progressiva precisa de um indicador visível. Use a dica estabelecida do projeto; sem uma, deixe o próximo item aparecer 16–32px além da borda de rolagem ou mostre um controle de divulgação. Conteúdo oculto sem nenhuma dica pode muito bem não existir.
6. Espaço de Respiração Entre Alvos
Sem um sistema de densidade estabelecido, comece com 12px entre controles adjacentes com borda ou preenchimento e 24px de folga ao redor de controles sem borda, apenas texto e ícone. Layouts compactos podem usar menos quando as áreas de toque do better-accessibility não se sobrepõem e os controles permanecem visualmente distintos.
7. Insira Botões para Dentro das Bordas
Em layouts de conteúdo, mantenha botões de largura total dentro das margens do layout (comece perto de 16px inline no mobile) com um raio visível. Ações de borda a borda são aceitáveis quando seguem intencionalmente a estrutura estabelecida da plataforma ou aplicativo, levam em conta áreas seguras e permanecem distinguíveis da UI do sistema.
8. Conteúdo Transborda, Controles Flutuam
Fundos e mídia se estendem até as bordas da viewport; controles e texto permanecem dentro das margens do layout e áreas seguras (env(safe-area-inset-*)). A estrutura fixa flutua acima da camada de conteúdo, não a represa.
9. Mantenha a Estrutura Até Que Ela Quebre
Breakpoints vêm do conteúdo, não de presets de dispositivos. Mantenha o layout expandido enquanto ele realmente couber e colapse tarde; prefira consultas de contêiner para adaptação em nível de componente. Teste primeiro os tamanhos menor e maior.
10. Planeje para Crescimento e Corte
Planeje para crescimento substancial de string dependente de idioma em vez de confiar em uma porcentagem universal: sem larguras ou alturas fixas em contêineres de texto, e deixe as linhas quebrarem. Nunca coloque ações críticas onde redimensionar ou rolar as corte; mantenha-as alcançáveis no fluxo normal ou em uma estrutura estável apropriada ao produto.
Erros Comuns
| Erro | Correção |
|---|---|
| Linha separadora onde o espaço bastaria | Remova a linha, dobre o espaço entre grupos |
margin-left / padding-right em um layout localizável | margin-inline-start / padding-inline-end |
| Botão de layout de conteúdo toca acidentalmente a viewport | Insira dentro das margens do projeto; preserve a estrutura intencional da plataforma |
| Carrossel/scroller que parece completo | Deixe o próximo item aparecer 16–32px além da borda |
| Controles adjacentes se fundem ou áreas de toque expandidas se sobrepõem | Aumente o espaço usando a escala do projeto; use 12px/24px como pontos de partida |
| Breakpoints em 768/1024 por serem os padrões | Quebre onde o conteúdo realmente para de caber |
| Contêiner de texto com largura fixa dimensionado para um idioma | max-width + quebra de linha; teste pseudo-localização e localidades representativas |
| Ação primária na parte inferior propensa a corte de um painel | Posicionamento fixo ou estrutura estável com padding de área segura |
Formato de Saída de Revisão
Use este formato apenas quando o usuário solicitar uma revisão de layout independente. Quando better-interface coordenar a revisão, forneça evidências de domínio e descobertas para essa skill e deixe seu formato de saída, escala de gravidade, regras de consolidação, limite e veredito prevalecerem.
Apresente a revisão independente em duas partes.
Descobertas
Agrupe todas as descobertas confirmadas por princípio. Use uma tabela markdown com colunas Gravidade, Localização, Antes, Depois e Por quê. Nunca use linhas separadas "Antes:" / "Depois:".
- Gravidade:
HIGHbloqueia conteúdo ou uma ação em uma viewport suportada;MEDIUMprejudica hierarquia, ordem de leitura ou adaptabilidade;LOWé polimento isolado de alinhamento ou espaçamento. - Localização: cite
caminho/para/arquivo:linha. Se o artefato não tiver arquivos de origem, cite a tela e o componente exatos. - Antes / Depois: mostre o layout atual e uma substituição acionável.
- Por quê: nomeie o princípio violado e seu efeito na compreensão ou adaptabilidade.
Consolide um problema sistêmico repetido em uma linha e liste todos os locais afetados. Omita princípios sem descobertas.
Exemplo
Agrupe com espaço, não com linhas
| Gravidade | Localização | Antes | Depois | Por quê |
|---|---|---|---|---|
| LOW | src/Settings.tsx:41 | border-b em cada linha de configurações | Remova bordas; use space-y-2 dentro dos grupos e space-y-8 entre grupos | Espaçamento comunica agrupamento com menos ruído visual |
| LOW | src/ProfileForm.tsx:58 | <hr> entre seções do formulário | Substitua por mt-10 em cada cabeçalho de seção | A hierarquia de seções não deve depender de réguas repetidas |
Alinhe a bordas compartilhadas
| Gravidade | Localização | Antes | Depois | Por quê |
|---|---|---|---|---|
| LOW | src/Card.tsx:24 | Texto do card em pl-4, ícone do card em pl-3 | Alinhe ambos à mesma borda pl-4 | Bordas compartilhadas criam uma estrutura legível |
| MEDIUM | src/Nav.css:19 | margin-left: 16px | margin-inline-start: 16px | Propriedades físicas quebram layouts cientes de direção |
Verificação e Veredito
Após as descobertas:
- Verificação: liste as verificações exatas realizadas e seus resultados observados nas larguras de viewport relevantes, ordem de leitura, zoom e estado RTL. Se uma verificação não foi realizada, indique o que ainda precisa ser verificado.
- Veredito:
Bloqueadose alguma descobertaHIGHpermanecer,Precisa de mudançasse apenas descobertasMEDIUMouLOWpermanecerem, eAprovadosomente quando não houver descobertas acionáveis.
Quando não houver descobertas, omita as tabelas, indique "Nenhuma descoberta de layout acionável", relate a verificação e termine com Aprovado.