Layout responsivo
Escreva o layout para que ele se adapte sozinho; depois, adicione breakpoints apenas onde o conteúdo realmente quebra. Layouts feitos primeiro para desktop e depois "remendados" para baixo são a origem da maioria dos bugs em mobile.
Base
*, *::before, *::after { box-sizing: border-box; }
html { -webkit-text-size-adjust: 100%; }
body { margin: 0; }
img, video, svg { max-width: 100%; height: auto; display: block; }
.container { width: min(100% - 2 * var(--gutter, 1.25rem), var(--container, 76rem)); margin-inline: auto; }
section { padding-block: var(--section, clamp(4rem, 3rem + 6vw, 9rem)); }
Padrões
Grade de cartões sem breakpoints
.grid { display: grid; gap: clamp(1rem, 2vw, 2rem);
grid-template-columns: repeat(auto-fit, minmax(min(100%, 18rem), 1fr)); }
min(100%, 18rem) evita overflow quando o contêiner é mais estreito que o mínimo. Use auto-fill se uma última linha curta não deve esticar.
Seção dividida (texto e mídia)
.split { display: grid; gap: clamp(2rem, 5vw, 5rem); align-items: center; }
@media (min-width: 62em) { .split { grid-template-columns: 1.1fr 0.9fr; }
.split--flip > :first-child { order: 2; } }
No mobile, decida deliberadamente o que vem primeiro; geralmente o texto, a menos que a imagem seja a mensagem.
Grade bento
.bento { display: grid; gap: 1rem; grid-template-columns: repeat(6, 1fr); grid-auto-rows: minmax(12rem, auto); }
.bento > .wide { grid-column: span 4; }
.bento > .half { grid-column: span 3; }
.bento > .third { grid-column: span 2; }
.bento > .tall { grid-row: span 2; }
@media (max-width: 61.99em) { .bento { grid-template-columns: repeat(2, 1fr); }
.bento > * { grid-column: span 1; grid-row: auto; } .bento > .wide { grid-column: span 2; } }
@media (max-width: 35.99em) { .bento { grid-template-columns: 1fr; } .bento > * { grid-column: auto; } }
Os spans de cada linha devem somar o número de colunas, senão aparecem lacunas. Esboce as linhas antes de escrever as classes.
Barra lateral fixa ao lado de conteúdo longo (FAQ, artigo)
.with-aside { display: grid; gap: 3rem; }
@media (min-width: 62em) { .with-aside { grid-template-columns: 22rem 1fr; align-items: start; }
.with-aside aside { position: sticky; top: 6rem; } }
position: sticky falha silenciosamente se algum ancestral tiver overflow: hidden ou auto. Use overflow: clip nos ancestrais.
Cabeçalho e menu mobile
- Desktop: logotipo, navegação inline, CTA. Recolher para um botão de menu quando a navegação não couber mais, não em uma largura arbitrária.
- O botão de menu é um
<button aria-expanded aria-controls>real. O painel prende o foco enquanto aberto, fecha com Escape e restaura o foco para o botão. - Travar a rolagem do fundo enquanto aberto (
overflow: hiddennohtml) e compensar a largura da barra de rolagem para evitar um salto no layout. - Submenus abrem ao clicar em dispositivos de toque; apenas hover é inacessível.
Responsividade no nível do componente
Quando um cartão aparece tanto em uma grade larga quanto em uma barra lateral estreita, use consultas de contêiner para que o cartão responda à sua própria largura:
.card-wrap { container-type: inline-size; }
@container (min-width: 28rem) { .card { display: grid; grid-template-columns: 10rem 1fr; } }
Breakpoints
Use em para que respeitem o zoom do usuário. Conjunto sugerido: 36em (576px), 48em (768px), 62em (992px), 75em (1200px). Adicione um apenas quando puder nomear o que quebra sem ele.
Caça ao overflow
A barra de rolagem horizontal no mobile é quase sempre uma destas causas:
- Uma
widthfixa em px em um elemento ou imagem. 100vwem algo dentro de um pai com padding (use100%).- Texto longo sem quebras, como URLs ou e-mails:
overflow-wrap: anywhere. - Um filho flex que não encolhe: adicione
min-width: 0. - Uma faixa de grade com
minmax(20rem, 1fr)em uma tela de 320px: envolva o mínimo emmin(100%, …). - Uma decoração com posicionamento absoluto fora da viewport: recorte a seção com
overflow: clip. - Margens negativas em uma linha de largura total.
Para encontrar o culpado, execute isto no console:
[...document.querySelectorAll("*")].filter(e => e.getBoundingClientRect().right > innerWidth + 1)
Detalhes de toque e viewport
- Alvos de toque com pelo menos 44 por 44px e 8px entre eles.
- Use
svh/dvhem vez devhpara seções de altura total, para que as barras do navegador mobile não cortem o conteúdo. - Inputs com tamanho de fonte 16px ou maior; menor faz o iOS aplicar zoom no foco.
- Respeite entalhes:
padding-inline: max(var(--gutter), env(safe-area-inset-left)).
Larguras de teste
320, 390, 768, 1024, 1440 e 1920. Teste também com zoom de 200% no navegador e com uma string traduzida longa na navegação.