# Navegação: instruções para agentes de IA

- Página: Menus, abas e paginação: navegação que não perde o visitante (https://brasilgeo.ai/leadlovers2026/design/navegacao/)
- Revisado em: 2026-11-16
- JSON com o mesmo conteúdo: https://brasilgeo.ai/leadlovers2026/design/navegacao/agentes.json
- Índice dos guias de Design para agentes: https://brasilgeo.ai/leadlovers2026/design/llms.txt
- Esquema: design-guia-para-agentes/v1

Decide como montar menus, abas e listas longas sem perder o visitante. Navegação escondida no desktop corta o uso; mega menu pede atraso de hover; o papel ARIA de menu não serve a navegação de site; aba guarda estado na URL; lista de produtos usa carregar mais com URLs paginadas por baixo. O resultado é navegação visível, acessível, indexável e medida pelo INP.

## Quando consultar

- Montar ou revisar menu principal, mega menu ou gaveta de navegação.
- Escolher entre abas, acordeão e página única.
- Implementar lista longa, catálogo ou resultado de busca.
- Definir alvo de toque e barra inferior no celular.
- Conferir o papel ARIA em menu gerado por IA.
- Guardar aba, filtro e página na URL e restaurar a rolagem ao voltar.
- Criar sumário, paleta de comandos ou tour em página grande.

## Regras

- **NAV-01** (obrigatória). No desktop, deixe visíveis os itens de alta frequência. Só o secundário vai para gaveta ou hambúrguer. Por quê: NN/g 2016: menu escondido usado em 27% dos casos contra 48% do visível; tarefas pelo menos 39% mais lentas.
- **NAV-02** (obrigatória). No celular o hambúrguer é tolerável, com a palavra "Menu" ao lado do ícone. Ação frequente vai na barra inferior com 3 a 5 destinos de igual importância. Por quê: No celular a lentidão é de 15% (NN/g 2016). A faixa de 3 a 5 vem do Material Design 3.
- **NAV-03** (obrigatória). Rótulo diz o que há depois do clique ("Ver planos e preços", não "Saiba mais"). Teste lendo cada rótulo isolado. Por quê: Aroma de informação (NN/g): a melhoria mais barata de uma navegação.
- **NAV-04** (obrigatória). Mega menu aberto por hover leva atraso de 300 a 500 ms antes de abrir, fechar e trocar de painel. Por quê: Baymard 2023: 60% dos sites não têm atraso e o painel fecha na diagonal do cursor.
- **NAV-05** (obrigatória). Navegação de site usa <nav>, lista e links, sem role="menu". Submenu usa botão com aria-expanded e aria-controls (disclosure, área que abre e fecha). Por quê: O exemplo oficial do W3C APG dispensa o papel menu; ele exige teclado de aplicativo que ninguém espera em link.
- **NAV-06** (obrigatória). role="menu" só em menu de ação (editar, duplicar, excluir), com setas, Home, End, Enter e Esc devolvendo o foco. Nunca com div e onClick. Por quê: Erro mais frequente em código de IA: o modelo lê "menu" no pedido e aplica o papel de aplicativo.
- **NAV-07** (obrigatória). Alvo de toque com no mínimo 24x24 px CSS (WCAG 2.5.8 AA). Mire 44x44 px (iOS, WCAG AAA) ou 48x48 dp (Android) e deixe 8 px entre vizinhos. Por quê: Três alvos de 24 px colados passam na auditoria e falham no polegar.
- **NAV-08** (obrigatória). Página atual com aria-current="page" e sinal visual além da cor. Um item corrente por conjunto de links. Por quê: Evita depender só de cor; :has() acende o item-pai a partir do atributo.
- **NAV-09** (obrigatória). Gaveta: foco preso no painel, Esc e clique fora fecham, foco volta ao gatilho e o Voltar do aparelho fecha a gaveta sem sair da página. Por quê: Gaveta que só chama showModal() faz o Voltar expulsar a pessoa do site.
- **NAV-10** (obrigatória). Gaveta no histórico: pushState ao abrir (mesma URL, estado mesclado, chave própria); popstate só sincroniza; fechar chama history.back() só se a entrada atual for da gaveta; flag contra duplo back(). Por quê: Sem isso sobra entrada vazia (Voltar só pisca) ou o roteador perde o estado.
- **NAV-11** (obrigatória). Abas só para visões paralelas do mesmo recurso, poucas, com conteúdo não padrão suplementar. Se a pessoa precisa comparar painéis, use página única. Por quê: NN/g (2024): alternar abas para comparar cobra memória de curto prazo.
- **NAV-12** (obrigatória). Abas seguem o padrão tabs do W3C: setas circulam, aria-selected marca a ativa, ativação ao focar só com painel pré-carregado; painel de rede pede Enter ou Espaço. Por quê: APG do W3C; cor sozinha não informa o leitor de tela.
- **NAV-13** (obrigatória). Estado compartilhável (aba, filtro, página, busca) vai na URL, validado ao ler. Digitação usa replaceState; só envio ou escolha cria entrada com pushState. Por quê: Link compartilhável e HTML certo no servidor; pushState a cada tecla enche o Voltar.
- **NAV-14** (obrigatória). Lista de produtos: botão "Carregar mais" com lazy-load e URLs paginadas reais por baixo. Rolagem infinita só em feed homogêneo sem tarefa específica. Por quê: Baymard (mais de 5.550 horas de teste, 2024) prefere carregar mais; NN/g 2022 limita a rolagem infinita a feeds.
- **NAV-15** (obrigatória). Cada página da coleção tem <a href> real para a vizinha, URL única (número fora do fragmento #) e rel="canonical" para ela mesma, nunca tudo para a página 1. Por quê: Google aposentou rel=next/prev; rastreadores não clicam nem rolam.
- **NAV-16** (obrigatória). Ao voltar do detalhe, restaure rolagem e foco: replaceState com posição antes do pushState e restauração só após repovoar os itens. Por quê: Baymard 2020: 13% dos grandes e-commerces devolvem ao topo da lista.
- **NAV-17** (obrigatória). Lote do carregar mais: desktop 100 a 150 itens (visual) ou 50 a 100 (especificação); celular 15 a 30. Por quê: Baymard 2020; 52% dos sites desktop erram a quantidade.
- **NAV-18** (recomendada). Abra o painel de menu com marcação já no HTML e revele no clique. Aceite: INP até 200 ms no percentil 75, com dado de campo. Por quê: INP é Core Web Vital desde março de 2024 (web.dev); montar a lista no clique paga dentro da janela medida.
- **NAV-19** (recomendada). Revelação progressiva com no máximo 2 níveis. Acordeão exclusivo por <details name>; bloco secundário com hidden="until-found", nunca display:none. Por quê: Nielsen 2006: mais de 2 níveis perdem o caminho de volta; display:none anula o Ctrl+F.
- **NAV-20** (recomendada). Recurso nativo novo entra por Baseline do dia, com a versão sem ele funcionando (anchor positioning e View Transitions entre documentos como melhoria progressiva). Por quê: webstatus.dev 18/08/2026: popover, details name e View Transitions do mesmo documento no Baseline; os outros não.

## Decisões rápidas

| Situação | Escolha | Evite |
| --- | --- | --- |
| Poucos destinos de topo (até cerca de 5) | Links visíveis em <nav>. | Hambúrguer no desktop. |
| Muitos destinos com subcategorias | Mega menu com atraso de 300 a 500 ms; no celular, acordeão ou gaveta. |  |
| Botão que mostra e esconde bloco (submenu, FAQ) | Disclosure com aria-expanded e aria-controls. | role="menu". |
| Comandos sobre a tela atual | Menu de ação com role="menu" e teclado completo, ou primitiva pronta (DropdownMenu). |  |
| Visões paralelas do mesmo objeto, sem comparação | Abas com estado na URL. | Abas quando é preciso comparar: use página única. |
| Lista de produtos de e-commerce | Carregar mais + lazy-load + URLs paginadas. | Rolagem infinita. |
| Grid de dados ou consulta com volta ao ponto | Paginação numerada (opcional: Speculation Rules com prefetch da próxima). |  |
| Feed homogêneo sem tarefa específica | Rolagem infinita com o Feed Pattern do W3C (Page Down/Up, Ctrl+End/Home). |  |
| Página com 30 ou mais seções | Sumário pegajoso com seção atual, paleta de comandos e trilha por papel (esmaecer, nunca remover). |  |

## Números de referência

| Valor | Para quê | Fonte |
| --- | --- | --- |
| 27% x 48% x 50% | Uso do menu no desktop: escondido, visível e combinado. | NN/g 2016, 179 pessoas, 6 sites |
| 39% (desktop) e 15% (celular) | Lentidão das tarefas com navegação escondida. | NN/g 2016 |
| 300 a 500 ms | Atraso de hover antes de abrir e fechar mega menu. | Baymard 2023 |
| 60% e 88% | 60% dos sites sem atraso de hover; 88% dos maiores e-commerces dos EUA usam mega menu por hover. | Baymard 2023 e 2025 |
| 24 px, 44 px, 48 dp, 44 pt (mínimo Apple 28) | Alvo de toque: WCAG AA, WCAG AAA, Android, iOS; folga de 8 px entre vizinhos. | WCAG 2.2, Google, Apple |
| 100 a 150, 50 a 100, 15 a 30 | Itens por lote: desktop visual, desktop de especificação, celular. | Baymard 2020 |
| 13% | E-commerces que perdem a posição da lista ao voltar. | Baymard 2020 |
| 200 ms no percentil 75 | Meta de INP do clique de menu, medida no campo. | web.dev |
| 150 a 300 ms | Duração do movimento de menu e painel; acima de 400 ms é lento. | Guia; NN/g 2020 |

## Erros comuns e a correção

- Erro: role="menu" na navegação do site. Corrija: <nav> com links; disclosure para submenu.
- Erro: Mega menu por hover sem atraso. Corrija: 300 a 500 ms para abrir, fechar e trocar painel.
- Erro: Rótulo genérico ("Saiba mais") Corrija: Rótulo que antecipa o destino.
- Erro: Aba ativa só no estado do componente. Corrija: Parâmetro validado na URL, aria-selected e setas.
- Erro: Rolagem infinita em catálogo sem URLs paginadas. Corrija: Carregar mais com <a href> para a próxima página e canonical próprio.
- Erro: Gaveta que só esconde o painel e deixa entrada no histórico. Corrija: history.back() quando a entrada é da gaveta; popstate sem novo push.
- Erro: abbr com title ou tooltip que some ao mover o ponteiro. Corrija: Termo como botão que abre popover (WCAG 1.4.13).

## Padrões de código

### Submenu em disclosure

Menu principal com submenu, sem role de menu.

```html
<nav aria-label="Principal">
  <ul>
    <li><a href="/" aria-current="page">Início</a></li>
    <li>
      <button type="button" aria-expanded="false"
              aria-controls="sub-produtos">Produtos</button>
      <ul id="sub-produtos" hidden>
        <li><a href="/planos">Ver planos e preços</a></li>
      </ul>
    </li>
  </ul>
</nav>
<script>
  const btn = document.querySelector("nav button[aria-controls]");
  const painel = document.getElementById(btn.getAttribute("aria-controls"));
  const alternar = (abrir) => {
    btn.setAttribute("aria-expanded", String(abrir));
    painel.hidden = !abrir;
  };
  btn.addEventListener("click", () => alternar(painel.hidden));
  painel.addEventListener("keydown", (e) => {
    if (e.key === "Escape") { alternar(false); btn.focus(); }
  });
</script>
```

### Atraso de hover no mega menu

Painel aberto por hover no desktop.

```js
const ATRASO = 400; // dentro da faixa de 300 a 500 ms
let timer = null;
let aberto = null;

const agendar = (acao) => {
  clearTimeout(timer);
  timer = setTimeout(acao, ATRASO);
};

document.querySelectorAll('[data-mega-item]').forEach((item) => {
  const painel = item.querySelector('[data-mega-painel]');
  item.addEventListener('mouseenter', () => agendar(() => {
    if (aberto && aberto !== painel) aberto.hidden = true;
    painel.hidden = false;
    aberto = painel;
  }));
  // Sair só fecha depois do atraso: perdoa a diagonal do cursor
  item.addEventListener('mouseleave', () => agendar(() => {
    painel.hidden = true;
    if (aberto === painel) aberto = null;
  }));
});
```

### Gaveta que respeita o Voltar

Filtros ou menu em <dialog> no celular.

```js
const CHAVE = 'minhaGaveta';
const gaveta = document.querySelector('#gaveta');
const gatilho = document.querySelector('#abrir-gaveta');
const estado = () => (history.state && typeof history.state === 'object' ? history.state : {});
const daGaveta = () => estado()[CHAVE]?.aberta === true;
let fechando = false; // flag contra dois back() seguidos

function abrir() {
  if (fechando || gaveta.open) return;
  history.pushState({ ...estado(), [CHAVE]: { aberta: true } }, '', location.href);
  sincronizar();
}
function fechar() {
  if (fechando) return;
  if (daGaveta()) { fechando = true; history.back(); }
  else { gaveta.close(); gatilho.focus(); }
}
// popstate só lê o histórico; nunca empurra entrada
function sincronizar(foco = false) {
  fechando = false;
  const aberta = daGaveta();
  if (aberta && !gaveta.open) gaveta.showModal();
  if (!aberta && gaveta.open) { gaveta.close(); if (foco) gatilho.focus(); }
  gatilho.setAttribute('aria-expanded', String(aberta));
}
gaveta.addEventListener('cancel', (e) => { e.preventDefault(); fechar(); }); // Esc
gatilho.addEventListener('click', abrir);
window.addEventListener('popstate', () => sincronizar(true));
sincronizar();
```

## Checklist antes de entregar

- [ ] Itens frequentes visíveis no desktop; hambúrguer só no celular, com a palavra "Menu".
- [ ] Cada rótulo faz sentido lido isoladamente.
- [ ] Navegação principal é <nav> com links; nenhum role="menu" fora de menu de ação.
- [ ] Mega menu com atraso de 300 a 500 ms.
- [ ] Alvos de toque com pelo menos 24x24 px (meta 44 px) e 8 px de folga.
- [ ] Item atual com aria-current="page" e sinal além da cor.
- [ ] Esc fecha e o foco volta ao gatilho em menu, gaveta e popover.
- [ ] Voltar do aparelho fecha a gaveta; history.length igual ao de antes da abertura.
- [ ] Lista longa com <a href> real, canonical por página e página 2 existente sem JavaScript.
- [ ] Voltar da ficha restaura rolagem e foco; rodapé alcançável.
- [ ] Teste a 390 px e só com teclado, sem rolagem horizontal; INP do menu até 200 ms.

## Ferramentas citadas

- **nuqs 2.10.2**: Estado de aba, filtro e página na URL em React; substitui a entrada do histórico por padrão.
- **shadcn/ui: NavigationMenu e DropdownMenu**: Primitivas separadas: NavigationMenu para links, DropdownMenu para ações.
- **Popover API, <details name>, dialog**: Camadas, acordeão exclusivo e gaveta modal sem biblioteca.

## Onde aprofundar na página

- [Custo de esconder a navegação](https://brasilgeo.ai/leadlovers2026/design/navegacao/#esconder)
- [Mega menu e atraso de hover](https://brasilgeo.ai/leadlovers2026/design/navegacao/#megamenu)
- [Os quatro sentidos de menu e papéis ARIA](https://brasilgeo.ai/leadlovers2026/design/navegacao/#padroes)
- [Abas e estado na URL](https://brasilgeo.ai/leadlovers2026/design/navegacao/#abas)
- [Paginar, carregar mais ou rolagem infinita](https://brasilgeo.ai/leadlovers2026/design/navegacao/#paginacao)
- [INP do clique de menu](https://brasilgeo.ai/leadlovers2026/design/navegacao/#inp)
- [Oficina da gaveta com histórico](https://brasilgeo.ai/leadlovers2026/design/navegacao/#oficina-gaveta-historico)

## Guias relacionados

- [Botões](https://brasilgeo.ai/leadlovers2026/design/botoes/): Rótulo, estados e hierarquia de botões de menu e de carregar mais. Instruções: https://brasilgeo.ai/leadlovers2026/design/botoes/agentes.md
- [React](https://brasilgeo.ai/leadlovers2026/design/react/): Menu, estado na URL e roteamento em React ou Next. Instruções: https://brasilgeo.ai/leadlovers2026/design/react/agentes.md
- [Tailwind e tokens](https://brasilgeo.ai/leadlovers2026/design/tailwind/): Menu com utilitários, tokens e variantes responsivas. Instruções: https://brasilgeo.ai/leadlovers2026/design/tailwind/agentes.md
- [Ícones](https://brasilgeo.ai/leadlovers2026/design/icones/): Ícone de hambúrguer e setas com rótulo acessível. Instruções: https://brasilgeo.ai/leadlovers2026/design/icones/agentes.md

## Fontes primárias

- [NN/g: Hamburger Menus and Hidden Navigation Hurt UX Metrics (2016)](https://www.nngroup.com/articles/hamburger-menus/)
- [NN/g: Infinite Scrolling (2022)](https://www.nngroup.com/articles/infinite-scrolling-tips/)
- [Baymard: atraso de hover em menus suspensos (2023)](https://baymard.com/blog/dropdown-menu-flickering-issue)
- [Baymard: itens carregados por padrão (2020)](https://baymard.com/blog/number-of-items-loaded-by-default)
- [W3C: WCAG 2.2](https://www.w3.org/TR/WCAG22/)
- [Google Search Central: paginação e carregamento incremental](https://developers.google.com/search/docs/specialty/ecommerce/pagination-and-incremental-page-loading)
