Communitygithub.com

Sistema de Navegação por Barra Lateral (Sidebar)

Projetar e implementar uma estrutura de navegação vertical persistente e hierárquica para aplicações web complexas, painéis e sites de documentação.

O que é Sistema de Navegação por Barra Lateral (Sidebar)?

O Sistema de Navegação por Barra Lateral é uma metodologia completa para criar estruturas de navegação vertical persistentes, ideais para aplicações web complexas como dashboards SaaS, painéis administrativos, sites de documentação e ferramentas internas. Diferente de cabeçalhos horizontais, a barra lateral é otimizada para arquiteturas de informação de alta densidade, suportando aninhamento profundo, ações utilitárias secundárias e alternância entre espaços de trabalho. O sistema define fluxos de trabalho que vão desde a organização hierárquica dos níveis de navegação até a especificação de anatomia visual, padrões de aninhamento (acordeão, flyout, drill-down) e matriz de estados interativos. Também inclui regras de decisão como o limite de sete itens no primeiro nível, exigência de ícones e persistência de rótulos no desktop. Projetado para ser usado com agentes de IA como Claude Code, Cursor e Codex, o sistema fornece entradas claras (arquitetura de informação, contextos de usuário, tokens de marca) e saídas definidas (especificação de anatomia, matriz de interação, mapeamento responsivo). A acessibilidade é um pilar fundamental: a barra lateral deve usar `<nav>` com `aria-label`, `aria-expanded` em itens aninhados, e garantir que o foco nunca fique oculto por sobreposições (WCAG 2.2). Targets de toque devem ter no mínimo 24x24px (recomendado 44x44px para itens primários). O sistema também inclui critérios de validação explícitos e padrões comuns de falha a serem evitados, como scroll dentro de scroll, estado ativo invisível e excesso de aninhamento.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/sidebar-navigation-system

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Sistema de Navegação por Barra Lateral

Propósito

O Sistema de Navegação por Barra Lateral fornece uma metodologia para projetar estruturas de navegação vertical persistentes. Ao contrário de cabeçalhos horizontais, as barras laterais são otimizadas para arquiteturas de informação de alta densidade, suportando aninhamento profundo, ações utilitárias secundárias e alternância entre espaços de trabalho. Este sistema garante que os usuários possam navegar por aplicações complexas com mínimo esforço cognitivo, mantendo uma noção clara de sua localização atual em um ambiente hierárquico.

Casos de Uso

  • Dashboards SaaS: Gerenciamento de múltiplos espaços de trabalho, ferramentas e visualizações de dados.
  • Painéis Administrativos: Organização de funções de gerenciamento extensas e configurações do sistema.
  • Sites de Documentação: Navegação por hierarquias profundas de artigos, seções e referências de API.
  • Ferramentas Internas: Estruturação de fluxos de trabalho complexos e módulos de entrada de dados.
  • Sistemas de Gerenciamento de Conteúdo (CMS): Alternância entre edição de páginas, bibliotecas de mídia e permissões de usuário.

Quando NÃO Usar

  • Páginas de Destino de Marketing: Onde um cabeçalho horizontal simples é mais apropriado para navegação focada em conversão.
  • Blogs Simples: Onde breadcrumbs e links de nível superior fornecem orientação suficiente.
  • Aplicativos para Consumidores Mobile-First: Onde uma barra de abas inferior é mais adequada para interação na zona primária do polegar.
  • Sites Narrativos Imersivos: Onde elementos de UI persistentes podem distrair da experiência de contar histórias.

Entradas

  1. Arquitetura de Informação (AI): Um mapa de todas as páginas e ferramentas, agrupadas por relação funcional.
  2. Contextos de Usuário: Identificação de diferentes funções de usuário e as tarefas principais que eles realizam.
  3. Níveis de Espaço de Trabalho: Determinar se o aplicativo requer alternância entre diferentes contas ou projetos.
  4. Tokens de Estilo da Marca: Cores, tipografia e espaçamento do sistema de design existente.
  5. Inventário de Componentes Interativos: Ícones padronizados, badges (para notificações) e botões.

Saídas

  1. Especificação de Anatomia da Barra Lateral: Regiões definidas (Marca, Alternância de Espaço de Trabalho, Navegação Primária, Navegação Secundária, Rodapé do Usuário).
  2. Matriz de Interação: Comportamento para hover, foco, estados ativos e aninhamento (expandir/recolher).
  3. Mapeamento Responsivo: Regras para como a barra lateral se transforma (ex.: Fixa -> Trilha Recolhida -> Gaveta Móvel).
  4. Especificações de Estado: Tratamentos visuais definidos para diferentes níveis de navegação e indicadores de notificação.

Fluxo de Trabalho

1. Definir os Níveis de Navegação

Organize a AI em uma hierarquia vertical:

  • Nível 1 (Direto): Seções principais sempre visíveis na lista primária.
  • Nível 2 (Aninhado): Subseções reveladas via expansão ou drill-down.
  • Ações Globais: Utilitários secundários como "Configurações", "Ajuda" ou "Notificações" geralmente colocados na parte inferior.

2. Estabelecer a Anatomia Visual

Divida a barra lateral em zonas funcionais:

  • Cabeçalho: Logotipo da marca e alternância de espaço de trabalho/conta.
  • Corpo (Rolável): A lista de navegação primária.
  • Rodapé (Fixo): Perfil do usuário, configurações do sistema e gatilho de recolher/expandir.

3. Projetar o Padrão de Aninhamento

Escolha como lidar com hierarquia profunda:

  • Acordeão: Seções expansíveis que empurram outros itens para baixo. Melhor para 2 níveis.
  • Flyout: Submenus que aparecem ao lado da barra lateral ao passar o mouse/clicar. Melhor para barras laterais estreitas ("trilha").
  • Drill-down: A visualização inteira da barra lateral é substituída por uma visualização de subnível. Melhor para estruturas muito profundas.

4. Criar a Matriz de Estados

Aplique feedback visual consistente (do sistema-de-estados-interativos):

  • Estado Ativo: Use um indicador de alto contraste (ex.: barra de cor ou mudança de fundo) para mostrar a página atual.
  • Hover/Foco: Mudança sutil de fundo para indicar interatividade.
  • Badges de Notificação: Use o sistema-de-badges-e-tags para mostrar itens não lidos ou status.

5. Planejar a Adaptação Responsiva

Mapeie o comportamento da barra lateral entre pontos de interrupção:

  • Desktop (>1200px): Barra lateral fixa, larga (240px-280px).
  • Tablet (768px-1200px): "Trilha" recolhida mostrando apenas ícones, expandindo ao passar o mouse/clicar.
  • Mobile (<768px): Oculta por padrão, aparecendo como uma gaveta em tela cheia acionada por um ícone de hambúrguer. Aplique o atributo inert (ou equivalente) ao conteúdo principal enquanto a gaveta estiver aberta, para que usuários de teclado e leitores de tela não possam tabular para o conteúdo oculto atrás dela.

Regras de Decisão

  • A Regra dos "Sete Itens": Limite os grupos de nível superior a sete ou menos para garantir que sejam facilmente escaneáveis sem rolagem.
  • Exigência de Iconografia: Sempre use ícones para itens de Nível 1. Ícones fornecem uma âncora visual que auxilia o reconhecimento, especialmente em estados recolhidos.
  • Persistência de Rótulos: Os rótulos nunca devem ser ocultados na visualização de desktop, a menos que o usuário recolha explicitamente a barra lateral.
  • Distinção Visual: Garanta que os itens de Nível 2 sejam visualmente distintos dos de Nível 1 (ex.: por meio de recuo, tamanho de fonte menor ou cor suave).
  • Visibilidade da Página Ativa: O indicador de página ativa deve ser o estado visual mais proeminente na barra lateral.

Restrições

  • Acessibilidade: A barra lateral deve estar envolta em um elemento <nav> com um aria-label único. Use aria-expanded para itens aninhados. Quando a barra lateral ou seus flyouts sobrepuserem conteúdo, garanta que o item atualmente focado nunca fique totalmente oculto atrás de outra camada (WCAG 2.2, 2.4.11 Foco Não Obstruído).
  • Responsividade: A barra lateral não deve sobrepor o conteúdo no desktop; ela deve empurrar ou comprimir a área de conteúdo principal.
  • Hierarquia Visual: Marca e alternadores de espaço de trabalho devem estar no topo; configurações do usuário e ajuda devem ficar na parte inferior.
  • Alvos de Toque: Todos os links e gatilhos de expansão devem atender ao menos o tamanho mínimo de 24x24px do WCAG 2.2 (2.5.8); 44x44px é preferível para itens de navegação primária devido à frequência de uso.

Padrões Comuns de Falha

  • Rolagem Dentro de Rolagem: Ter uma barra lateral rolável e uma área de conteúdo rolável que competem pelo foco do usuário, gerando uma sensação de "sequestro de rolagem".
  • Estado "Ativo Invisível": Tornar o indicador de página atual tão sutil que o usuário perde sua localização.
  • Aninhamento Excessivo: Ir mais fundo que 3 níveis, fazendo a navegação parecer um sistema de arquivos em vez de um aplicativo.
  • Gatilho de Recolhimento Oculto: Esconder o botão "Fechar" ou "Recolher" em um lugar onde os usuários não possam encontrá-lo.
  • Ícones Não Rotulados: Usar ícones sem rótulos de texto na visualização principal, confiando em navegação "mystery meat".

Critérios de Validação

  • A barra lateral está estruturada em zonas claras (Cabeçalho, Corpo, Rodapé).
  • O estado ativo é claramente distinto dos estados de hover e padrão.
  • Todos os itens de Nível 1 possuem um ícone exclusivo e reconhecível.
  • Os itens aninhados estão visualmente subordinados aos seus itens pai.
  • A barra lateral é totalmente navegável por teclado (teclas Tab e Seta).
  • Os estados responsivos para Mobile e Tablet estão definidos e funcionais.
  • Os landmarks e estados ARIA estão implementados corretamente.
  • As taxas de contraste para texto e indicadores atendem ao WCAG AA (4.5:1).
  • Os alvos de toque atendem ao mínimo de 24x24px do WCAG 2.2.
  • A gaveta móvel aplica inert (ou equivalente) ao conteúdo de fundo enquanto está aberta.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas