Menu móvel premium
Um menu móvel é composto por quatro elementos conectados a um único estado booleano: um botão que se transforma, um painel que se revela, a página atrás dele mantida parada e o foco mantido dentro. Quase todo menu quebrado está quebrado porque esses quatro elementos saíram de sincronia — um deles é alternado em outro lugar, por outra coisa.
Dirija tudo a partir de uma única função set(state). Sem classList.toggle() espalhado por manipuladores de clique, sem caminho "fechar" separado que esquece o bloqueio de rolagem. Uma função, cada atributo, ambas as direções.
Estrutura
O cabeçalho tem prioridade sobre o painel, e o painel cobre tudo o mais:
.nav { position: fixed; inset: 0 0 auto; z-index: 210 } /* burger vive aqui */
.menu { position: fixed; inset: 0 0 auto; z-index: 200; height: 100dvh }
<header class="nav">
<a class="brand" href="/">silva</a>
<button class="burger" id="menuBtn" type="button"
aria-label="Abrir menu" aria-expanded="false" aria-controls="menu">
<i></i><i></i>
</button>
</header>
<div class="menu" id="menu" role="dialog" aria-label="Menu" tabindex="-1" inert>
<nav class="menu__nav">
<a href="#about"><span class="menu__idx">01</span> Sobre</a>
<a href="#work"><span class="menu__idx">02</span> Trabalho</a>
</nav>
<div class="menu__foot">...</div>
</div>
O burger permanece no cabeçalho e se transforma no lugar. Ele é o controle de abertura e o controle de fechamento, razão pela qual o cabeçalho precisa ficar acima do painel — veja a Armadilha 1.
O botão
Alvo de 44×44, 22px de barra visível. As barras são posicionadas absolutamente e centralizadas com margens, não com transformações, para que a propriedade transform permaneça livre para a transformação:
.burger {
position: relative; display: grid; place-items: center;
width: 44px; height: 44px;
background: none; border: 0; padding: 0; cursor: pointer;
color: currentColor;
-webkit-tap-highlight-color: transparent;
}
.burger i {
position: absolute; left: 50%; top: 50%;
margin: -.75px 0 0 -11px; /* centralização está aqui, não no transform */
width: 22px; height: 1.5px;
background: currentColor; border-radius: 2px;
transition: transform .45s var(--ease);
}
.burger i:first-child { transform: translateY(-4px) }
.burger i:last-child { transform: translateY(4px) }
html.is-menu-open .burger i:first-child { transform: rotate(45deg) }
html.is-menu-open .burger i:last-child { transform: rotate(-45deg) }
Ambas as barras compartilham um ponto central, então girá-las em ±45° produz um X simétrico sem segundo keyframe e sem nada para ajustar. Se você centralizar com translate(-50%,-50%), cada estado de transformação tem que reafirmar esse translate e as duas barras se desviam por um pixel.
Use duas barras, não três. O X de três barras precisa que a do meio desapareça enquanto as duas externas convergem, e o desaparecimento é visível como um borrão cinza no meio da transição. Duas barras se transformam limpidamente. Se um estado de repouso de três barras é inegociável, anime as barras externas com translateY + rotate e dê à opacity do meio uma duração menor para que ela desapareça antes da rotação começar.
Nunca anime top/margin para mover as barras. Transform apenas.
O painel
.menu {
position: fixed; left: 0; right: 0; top: 0;
height: 100dvh; /* não inset:0 — veja Armadilha 2 */
z-index: 200;
display: flex; flex-direction: column; justify-content: space-between;
padding: clamp(96px, 24vw, 150px) var(--gutter)
max(clamp(28px, 7vw, 52px), env(safe-area-inset-bottom));
background: var(--black); color: var(--white);
overflow-y: auto; overscroll-behavior: contain;
opacity: 0; visibility: hidden; transform: translateY(-12px);
transition: opacity .45s var(--ease),
transform .55s var(--ease),
visibility 0s linear .45s; /* esconder apenas após o fade terminar */
}
.menu.is-open {
opacity: 1; visibility: visible; transform: none;
transition-delay: 0s; /* cancelar o atraso de visibilidade no caminho de entrada */
}
visibility é o que torna isso seguro para teclado: remove o painel fechado da ordem de tabulação, o que opacity: 0 sozinho não faz. A transição de visibility com atraso é todo o truque — visível imediatamente ao abrir, escondido apenas depois que o fade-out termina.
A revelação escalonada de links é o que parece caro:
.menu__nav a {
opacity: 0; transform: translateY(18px);
transition: opacity .6s var(--ease), transform .6s var(--ease);
}
.menu.is-open .menu__nav a { opacity: 1; transform: none }
.menu.is-open .menu__nav a:nth-child(1) { transition-delay: .10s }
.menu.is-open .menu__nav a:nth-child(2) { transition-delay: .16s }
.menu.is-open .menu__nav a:nth-child(3) { transition-delay: .22s }
.menu.is-open .menu__nav a:nth-child(4) { transition-delay: .28s }
.menu.is-open .menu__nav a:nth-child(5) { transition-delay: .34s }
60ms de intervalo. Abaixo de ~40ms lê-se como um bloco; acima de ~90ms o último item parece atrasado. Para uma lista de comprimento desconhecido, coloque style="--i:3" em cada item e use transition-delay: calc(.10s + var(--i) * .06s).
No caminho de saída, remova os atrasos (.menu:not(.is-open) .menu__nav a { transition-delay: 0s }). Uma saída escalonada faz o fechamento parecer lento — o fechamento deve ser imediato.
A função de estado
(function () {
var btn = document.getElementById('menuBtn');
var panel = document.getElementById('menu');
var root = document.documentElement;
var open = false;
var scrollY = 0;
var FOCUSABLE = 'a[href], button:not([disabled]), input, select, textarea,' +
'[tabindex]:not([tabindex="-1"])';
// o burger é o controle de fechamento e vive fora do painel, então pertence ao ciclo
function focusables() {
return [btn].concat([].slice.call(panel.querySelectorAll(FOCUSABLE)));
}
function set(state) {
if (state === open) return;
open = state;
panel.classList.toggle('is-open', open);
root.classList.toggle('is-menu-open', open);
btn.setAttribute('aria-expanded', String(open));
btn.setAttribute('aria-label', open ? 'Fechar menu' : 'Abrir menu');
if (open) panel.removeAttribute('inert');
else panel.setAttribute('inert', '');
if (open) {
scrollY = window.scrollY;
document.body.style.position = 'fixed';
document.body.style.top = -scrollY + 'px';
document.body.style.left = '0';
document.body.style.right = '0';
panel.focus({ preventScroll: true });
} else {
document.body.style.position = '';
document.body.style.top = '';
document.body.style.left = '';
document.body.style.right = '';
window.scrollTo(0, scrollY);
btn.focus({ preventScroll: true });
}
}
btn.addEventListener('click', function () { set(!open); });
panel.querySelectorAll('a').forEach(function (a) {
a.addEventListener('click', function () { set(false); });
});
document.addEventListener('keydown', function (e) {
if (!open) return;
if (e.key === 'Escape') { set(false); return; }
if (e.key !== 'Tab') return;
var list = focusables();
var first = list[0];
var last = list[list.length - 1];
if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
});
// cruzar o ponto de quebra não deve prender a página em um estado bloqueado
matchMedia('(min-width: 1101px)').addEventListener('change', function (e) {
if (e.matches) set(false);
});
})();
inert substitui aria-hidden aqui. Nunca coloque aria-hidden="true" em um painel que pode conter foco — se o foco está dentro dele, você escondeu o elemento focado da árvore de acessibilidade, o que é um erro de autoria que leitores de tela lidam mal. inert bloqueia o foco e esconde da árvore em um único atributo.
Note o role="dialog" sem aria-modal="true". aria-modal diz à tecnologia assistiva para ignorar tudo fora do diálogo, e o botão de fechar está fora dele. Ou remova aria-modal (como acima) ou coloque um botão de fechar real dentro do painel.
Armadilha 1 — o cabeçalho deve ter prioridade sobre o painel
O burger se transforma no X, então ele precisa permanecer clicável enquanto o painel está aberto. Se o z-index do painel for maior que o do cabeçalho, o X é renderizado (é pintado no cabeçalho) mas todo clique cai na sobreposição. O menu se torna uma armadilha sem saída visível — reportado como "o botão de fechar não faz nada."
Dê ao cabeçalho um z-index maior que o do painel e verifique ambos contra todas as outras camadas fixas na página (barras de cookies e CTAs fixos são as colisões comuns). Um conjunto testado: painel 200, cabeçalho 210, toasts 9000.
Elementos fixos só se empilham uns contra os outros quando compartilham um contexto de empilhamento. Um transform, filter, opacity < 1 ou will-change em qualquer ancestral cria um novo e silenciosamente reparentaliza toda a comparação.
Armadilha 2 — overflow: hidden no body não segura iOS
document.body.style.overflow = 'hidden' bloqueia navegadores de desktop e não faz nada para um arrasto de toque no Safari do iOS. A página faz rubber-band atrás do painel e, ao soltar, o usuário está em outro lugar completamente.
O bloqueio que funciona é prender o body e restaurar o deslocamento, que é o que set() acima faz. Dois detalhes que o acompanham:
overscroll-behavior: containno painel impede que a própria rolagem do painel se encadeie com a página quando atinge um limite.- Restaure com
window.scrollTo(0, scrollY)na mesma chamada que limpaposition. LerscrollYdepois que o body é destravado dá 0.
Se o seu cabeçalho é position: sticky em vez de fixed, este bloqueio o quebra. Um body preso não tem viewport de rolagem, então o sticky resolve contra o documento e o cabeçalho pula para o topo da página — para fora da tela, levando o burger junto. Troque para fixed enquanto o menu está aberto (html.is-menu-open .nav { position: fixed; top: 0 }). A skill lenis-smooth-scroll cobre a mesma falha do lado do Lenis; se essa biblioteca estiver na página, use lenis.stop() em vez de um segundo bloqueio para não empilhar ambos.
Teste o bloqueio em um deslocamento de rolagem diferente de zero. Na rolagem 0, um bloqueio quebrado é pixel-idêntico a um funcionando. Role para ~1200, abra, arraste, feche: a posição deve ler 1200 em todo o processo.
Armadilha 3 — display: none não pode ser transicionado
Alternar display pula a animação completamente: o painel aparece e desaparece instantaneamente. O padrão de visibility + transição com atraso acima é a versão que funciona em todo lugar.
O equivalente moderno, se você está disposto a exigir uma base de 2024+:
.menu { display: none; opacity: 0;
transition: opacity .45s var(--ease), display .45s allow-discrete }
.menu.is-open { display: flex; opacity: 1 }
@starting-style { .menu.is-open { opacity: 0 } }
@starting-style é necessário — sem ele a entrada não tem valor inicial e apenas a saída é animada.
Armadilha 4 — o painel é o lugar errado para um desfoque de fundo
backdrop-filter em um painel em tela cheia reamostra tudo atrás dele a cada quadro, e em Android de gama média derruba a animação de entrada para fps de um dígito. Em uma build, remover um blend/desfoque de viewport inteiro reduziu os quadros perdidos de 34% para 3%.
Um menu premium é quase sempre um painel opaco com cores da marca, não vidro fosco. Se o design pedir vidro, desfoque um elemento pequeno (uma folha que cobre parte da tela), nunca o viewport inteiro, e veja a skill liquid-glass.
Armadilha 5 — os estados que ninguém testa
- Redimensionar além do ponto de quebra enquanto aberto. Manipulado acima com
matchMedia, não com um listenerresize, então dispara uma vez na travessia em vez de a cada quadro de um arrasto. - Mudança de rota no lado do cliente. Na navegação Next/Astro/SPA o painel sobrevive à navegação. Chame
set(false)no evento do roteador e limpe os estilos do body no desmonte. - Botão voltar após abrir. Se você empurra uma entrada de histórico quando o menu abre, o botão voltar deve fechá-lo em vez de deixar a página.
- Zoom para 200%. O painel deve rolar em vez de cortar seu rodapé.
- Telefone em paisagem.
100dvhcom um painel rolável cuida disso; uma listajustify-content: centerverticalmente centralizada não cuida.
Movimento reduzido
@media (prefers-reduced-motion: reduce) {
.menu, .menu__nav a, .burger i {
transition-duration: .01ms !important;
transition-delay: 0s !important;
}
}
Mantenha as mudanças de estado, descarte a coreografia. O painel ainda deve aparecer e desaparecer.
O que o faz parecer premium
Os mecanismos acima são o básico. Estas são as escolhas que o separam de uma gaveta bootstrap:
- Easing.
cubic-bezier(.16, 1, .3, 1)(expo-out) no painel e nos links. Partida rápida, estabilização longa. Nuncaeaseoulinear. - Timing. Painel 450–600ms, links 600ms com escalonamento de 60ms, transformação do burger 450ms. Abaixo de 300ms nada é registrado como movimento; acima de 700ms parece lento.
- Tipo. A lista de links é o design.
clamp(1.65rem, 8.4vw, 2.9rem), peso da fonte 300,line-height: 1, maiúsculas, tracking apertado. Regras finas entre as linhas. - Numerais de índice.
01 / 02 / 03em mono pequeno ou maiúsculas com espaçamento antes de cada rótulo, definido em um tom suave. Barato de adicionar, faz mais pela qualidade percebida do que qualquer efeito. - Áreas de toque em linha inteira. Padding vertical de
clamp(14px, 3.4vw, 22px)na própria âncora, não uma margem ao redor, para que a linha inteira seja tocável. - Um estado
:active, não um estado:hover. Telefones não têm hover, e um estilo hover que persiste após um toque parece quebrado. - Um bloco de rodapé — linha de contato, redes sociais, um único CTA em pílula — fixado por
justify-content: space-between. Espaço vazio no fundo é o que faz um menu parecer um placeholder. - Sem bounce ou spring no próprio painel. Overshoot em uma superfície em tela cheia parece barato. Guarde spring easing para elementos pequenos.
Checklist
- Uma função
set(state)controla classe,aria-expanded, rótulo,inerte bloqueio de rolagem -
z-indexdo cabeçalho está acima do painel, verificado contra todos os outros fixos
...