Communitygithub.com

Sistema de Cabeçalho Fixo e Barra Superior

Projete, estruture e otimize sistemas de barras superiores fixas e adesivas – incluindo barras de avisos, cabeçalhos utilitários, navegação principal, comportamentos de encolhimento ao rolar, padrões dinâmicos de ocultar/revelar, transições de elevação superficial e conformidade com acessibilidade WCAG AA.

O que é Sistema de Cabeçalho Fixo e Barra Superior?

Este skill oferece uma estrutura abrangente para a criação de sistemas de cabeçalho fixo e barras superiores, comuns em sites modernos e aplicações web. Ele aborda desde a arquitetura de barras em camadas (anúncio, utilidade e navegação principal) até comportamentos sofisticados de rolagem, como encolhimento, ocultação dinâmica ao descer e revelação ao subir. O skill especifica requisitos de acessibilidade WCAG AA, incluindo links de pular para o conteúdo, compensação de scroll-margin-top para âncoras e gerenciamento de foco de teclado. Suporta plataformas baseadas em CSS e JavaScript, fornecendo regras de implementação para z-index, transições suaves com aceleração por hardware e adaptação responsiva para dispositivos móveis, limitando a altura do cabeçalho a 64px. É ideal para e-commerce, SaaS, portais de conteúdo e aplicações web que precisam de navegação persistente e acessível sem comprometer a usabilidade ou o desempenho.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/sticky-header-and-top-bar-system

Perguntar na sua IA favorita

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

Documentação

O que Sistema de Cabeçalho Fixo e Barra Superior faz?

Propósito

O Sistema de Cabeçalho Fixo e Barra Superior fornece uma estrutura abrangente para projetar, estruturar e configurar o comportamento de pilhas de navegação persistentes no topo da página. Aplicações web modernas e sites de marketing frequentemente utilizam barras superiores em camadas – combinando banners promocionais, links utilitários secundários (seletores de moeda/idioma, links de suporte, localizadores de lojas) e barras de navegação principal.

Quando essas barras permanecem fixas ou adesivas durante a rolagem, sistemas mal arquitetados introduzem problemas críticos de usabilidade: consomem espaço vertical excessivo da viewport em dispositivos móveis, ocultam o conteúdo alvo de âncoras (incompatibilidade de scroll-margin-top), causam travamentos de layout ou instabilidade durante mudanças de estado de rolagem, geram conflitos de empilhamento z-index com modais ou menus suspensos e podem prender o foco do teclado ou quebrar a navegação por leitores de tela. Este skill estabelece padrões de design, composição espacial, lógica de estado de rolagem, estilo de elevação e acessibilidade para cabeçalhos fixos.

Casos de Uso

  • Cabeçalhos Globais de E-Commerce: Barras superiores multicamadas combinando banners de anúncio no topo (progresso de código promocional / frete grátis), links utilitários (login da conta, seletor de região, localizador de loja) e navegação principal fixa com barra de pesquisa e badge do carrinho.
  • Cabeçalhos de Marketing SaaS e Product Marketing: Cabeçalhos limpos que encolhem ao rolar (reduzindo padding/tamanho do logotipo) ou ocultam dinamicamente ao rolar para baixo / revelam ao rolar para cima, maximizando a área de conteúdo vertical enquanto preservam acesso instantâneo à navegação.
  • Cabeçalhos de Portais de Conteúdo e Publicações: Cabeçalhos fixos integrando barras de progresso de leitura, navegação por categorias, indicadores de título de artigo e ferramentas flutuantes de marcador/compartilhamento.
  • Aplicações Web e Shells de App SaaS: Barras superiores fixas contendo breadcrumbs, trocadores de workspaces ativos, acionadores de pesquisa por comando, menus de perfil de usuário e sinos de notificação em tempo real.

Quando NÃO Usar

  • Barras de Ferramentas de Formatação no Canvas: Para barras de ferramentas de editores rich-text ou docks de ação em lote que flutuam sobre o conteúdo ou se fixam a componentes específicos do editor, use toolbar-and-action-dock-system.
  • Barras de Navegação Inferior para Mobile: Para abas primárias de aplicativos móveis fixadas na parte inferior da viewport, use bottom-navigation-system.
  • Shells de Navegação Lateral Completa: Para aplicações web SaaS complexas onde a navegação principal é impulsionada por uma barra lateral esquerda recolhível, use sidebar-navigation-system.
  • Docks de Ação Flutuante: Para botões contextuais flutuantes fixados em cantos da viewport (ex.: widgets de chat, FABs de voltar ao topo), use sticky-and-floating-ui-system.

Entradas

  1. Arquitetura de Camadas da Barra Superior: Especificação das camadas presentes (ex.: Camada 1: Barra de Anúncio, Camada 2: Cabeçalho Utilitário, Camada 3: Navegação Principal).
  2. Modelo de Comportamento de Rolagem: Mecânica fixa desejada (sticky-always, shrink-on-scroll, hide-on-scroll-down / reveal-on-scroll-up ou static-to-sticky).
  3. Tokens de Superfície e Tema: Cores de fundo da superfície, tokens de borda, efeitos de desfoque de fundo (backdrop-filter: blur()) e sombras de elevação do elevation-and-depth-system e accessible-color-system.
  4. Alvos de Viewport e Dispositivo: Limites de breakpoint (< 768px, < 1024px, ≥ 1024px) para recolher cabeçalhos desktop multicamadas em barras superiores móveis unificadas.

Saídas

  1. Especificação de Layout e Empilhamento do Cabeçalho Fixo: Estruturas CSS Grid/Flexbox definindo posicionamento fixo/adesivo, variáveis CSS de deslocamento (--header-height) e hierarquia de escala z-index.
  2. Regras de Transição de Estado de Rolagem e Movimento: Especificação técnica para lógica de listeners de rolagem, offsets de limiar, classes CSS de transição (.is-scrolled, .is-hidden) e transformações aceleradas por hardware (transform: translateY()).
  3. Especificação de Recolhimento Responsivo para Mobile: Regras de layout que convertem barras superiores desktop de várias linhas em um único cabeçalho móvel compacto com alternador de gaveta.
  4. Blueprint de Acessibilidade WCAG AA: Implementação de link de pular (skip-link), compensação de scroll-margin-top para âncoras de cabeçalhos, prevenção de aprisionamento de foco de teclado e estrutura de landmark para leitores de tela (<header>, <nav>, role="banner").

Fluxo de Trabalho

1. Estruturar a Hierarquia de Empilhamento da Barra Superior

Determine a composição da barra superior multicamadas e estabeleça o layout HTML semântico:

  • Container HTML Semântico: Envolva todas as barras superiores dentro de uma única tag <header role="banner"> para manter um landmark de banner claro para usuários de leitores de tela.
  • Camada 1: Barra de Anúncio (<aside> ou <div>): Micro-banner de alta prioridade no topo absoluto (ex.: limite de frete grátis, alerta do sistema).
  • Camada 2: Barra Utilitária (<div class="utility-bar">): Links secundários, seletores de idioma/moeda, links de contato, suporte ao cliente.
  • Camada 3: Navegação Principal (<nav aria-label="Navegação Principal">): Logotipo da marca, links de seções primárias, campo de pesquisa, link da conta, carrinho de compras ou CTA principal.

2. Definir Posicionamento e Mecânica de Rolagem

Escolha a abordagem de implementação fixa com base na densidade de conteúdo e restrições da viewport:

  • position: sticky vs position: fixed:
    • Prefira position: sticky; top: 0; z-index: 1000; no container quando permitir o fluxo natural do documento antes de travar ao topo.
    • Use position: fixed; top: 0; left: 0; right: 0; quando o conteúdo do corpo explicitamente usar padding-top: var(--header-height);.
  • Estratégia de Recolhimento por Rolagem Multicamadas:
    • Ao rolar além de um limiar (ex.: scrollY > 50px), a Barra de Anúncio e a Barra Utilitária saem de vista naturalmente, enquanto a Navegação Principal trava (position: sticky; top: 0;) OU todo o cabeçalho faz a transição.
    • Calcule propriedades CSS personalizadas dinamicamente (ex.: --header-height) para que o conteúdo principal da página e os links de âncora se ajustem corretamente.

3. Implementar Transições de Estado de Rolagem e Microinterações

Aprimore a ergonomia do cabeçalho à medida que o usuário rola a página:

  • Transição de Encolhimento ao Rolar:
    • Estado padrão (no topo): Altura do cabeçalho 80px, altura do logotipo 40px, padding 1.25rem 2rem.
    • Estado rolado (.is-scrolled): Altura do cabeçalho 60px, altura do logotipo 30px, padding 0.75rem 2rem.
    • Animação suave: Use transições CSS aceleradas por hardware (transition: padding 0.25s ease, height 0.25s ease, background-color 0.25s ease, box-shadow 0.25s ease;).
  • Ocultação/Revelação Dinâmica (Cabeçalho Inteligente):
    • Rolando para Baixo (scrollY > lastScrollY && scrollY > 150px): Aplique transform: translateY(-100%); para deslizar o cabeçalho para fora da tela, maximizando a viewport de leitura.
    • Rolando para Cima (scrollY < lastScrollY): Aplique transform: translateY(0); para revelar imediatamente a navegação.
  • Elevação de Superfície e Desfoque de Fundo:
    • No topo da página: Fundo semitransparente ou fundo plano sem sombra.
    • Ao rolar: Adicione superfície sólida/glassmórfica (background-color: rgba(255, 255, 255, 0.85); backdrop-filter: blur(12px);) e sombra de elevação (box-shadow: 0 4px 20px rgba(0, 0, 0, 0.08);).

4. Configurar Adaptação para Viewport Móvel

Viewports móveis (< 768px) têm espaço vertical severamente limitado:

  • Teto de Altura do Cabeçalho Móvel: Limite a altura do cabeçalho fixo móvel a no máximo 56px–64px para evitar consumir >10% da altura da tela móvel.
  • Redução de Camadas Móveis: Oculte Barras Utilitárias secundárias no mobile, transferindo links utilitários para a Gaveta de Navegação Móvel recolhível.
  • Consolidação da Barra de Anúncio: Comprima o texto do anúncio em micro-cópia concisa ou ticker de rotação automática, ou mantenha estático acima do cabeçalho principal fixo.

5. Garantir Acessibilidade WCAG AA e Gerenciamento de Foco

  • Link de Pular para o Conteúdo Principal: Forneça um link de pular de nível superior como o primeiro elemento focalizável (<a href="#main-content" class="skip-link">Pular para o conteúdo principal</a>). Quando focado via Tab, posicione-o visivelmente sobre o cabeçalho fixo (top: 1rem; left: 1rem; z-index: 9999;).
  • Margem de Rolagem de Alvo de Âncora (scroll-margin-top): Evite que cabeçalhos fixos se sobreponham a cabeçalhos quando os usuários clicam em links de âncora internos ou itens de índice:
    :target, [id] {
      scroll-margin-top: calc(var(--header-height) + 1.5rem);
    }
    
  • Navegação por Teclado e Menus Suspensos: Garanta que todos os menus suspensos do cabeçalho (mega-menus, menus de conta, alternador de hambúrguer móvel) sejam totalmente operáveis via Tab, Enter, Space e Escape.
  • Prefers-Reduced-Motion: Respeite as preferências de movimento do usuário desabilitando transformações de deslizamento e transições de layout:
    @media (prefers-reduced-motion: reduce) {
      .site-header { transition: none !important; }
    }
    

Regras de Decisão

Matriz de Seleção de Mecânica de Rolagem Fixa

Tipo de SiteComportamento de Rolagem RecomendadoAdaptação MóvelJustificativa
Loja de E-CommerceNav Principal Fixa + Barras Superiores EstáticasBarra de promoção superior sai ao rolar; Nav principal permanece fixa (56px)Mantém pesquisa, contagem do carrinho e categorias acessíveis o tempo todo para maximizar conversão.
Landing / Marketing SaaSEncolher ao Rolar ou Ocultar/Revelar InteligenteCabeçalho unificado de 60px; oculta ao rolar para baixo, revela ao rolar para cimaMaximiza o canvas visual do hero e o espaço de leitura, ao mesmo tempo que fornece acesso instantâneo à navegação por intenção.
Blog de Conteúdo / EditorialOcultar/Revelar Inteligente com Progresso de LeituraBarra superior compacta com indicador de barra de progresso de rolagemDá 100% do espaço da viewport para leitura de formato longo, retornando a navegação instantaneamente na rolagem reversa.
App Web / DashboardCabeçalho Sempre Visível FixoCabeçalho de linha única fixo (56px)Funciona como shell utilitário do app; ocultação dinâmica causa desorientação durante o fluxo de trabalho.

Escala de Camadas Z-Index

Mantenha uma orquestração rigorosa de z-index em todo o sistema de design global:

z-index: 10000; -> Link de Pular para o Conteúdo (quando focado)
z-index: 9000;  -> Diálogos Modais / Lightboxes
z-index: 8000;  -> Gaveta de Navegação Móvel / Overlay
z-index: 7000;  -> Banners de Toast e Notificação Globais
z-index: 1000;  -> Pilha de Cabeçalho Fixo / Adesivo
z-index: 500;   -> Barras de Ferramentas Contextuais e Docks Flutuantes
z-index: 1;     -> Cartões de Conteúdo em Contexto de Empilhamento

Restrições

  • Acessibilidade (WCAG 2.1 AA):
    • SC 2.4.1 Bypass Blocks: Deve incluir um link visível "Pular para o Conteúdo Principal" precedendo a navegação do cabeçalho.
    • SC 1.4.3 Contraste: Texto do cabeçalho, ícones e acionadores de menu devem satisfazer a taxa de contraste mínima de 4.5:1 tanto no estado rolado quanto no não rolado do cabeçalho.
    • SC 2.4.7 Foco Visível: Indicadores de foco devem permanecer totalmente visíveis e sem recorte ao navegar por tabulação pelos elementos do cabeçalho fixo sobre qualquer cor de fundo.
  • Desempenho e Renderização:
    • Listeners de rolagem devem ser limitados ou vinculados via requestAnimationFrame ou IntersectionObserver para evitar travamentos de layout síncronos forçados durante eventos de rolagem.
    • Filtros de desfoque (backdrop-filter) devem ser escopados cuidadosamente e testados quanto a lag de GPU em dispositivos móveis de baixa potência.
  • Proteção de Layout da Viewport: Cabeçalhos fixos em dispositivos móveis nunca devem exceder 64px de altura ou 15% da altura da viewport visual quando fixos.

Padrões Comuns de Falha

  • Bug de Sobreposição de Conteúdo Âncora: Clicar em um link interno (#section-2) rola o cabeçalho da seção diretamente para baixo do cabeçalho fixo, tornando o título invisível porque scroll-margin-top foi omitido.
  • Consumo de Tela da Viewport: Manter um cabeçalho fixo desktop multicamadas de 140px em telas móveis, deixando menos de 60% da tela móvel visível para o conteúdo real da página.
  • Travamento de Layout por Rolagem: Consultar header.offsetHeight dentro de um listener window.onscroll sem limitação, causando travamento de layout e rolagem irregular a 30fps.
  • Conflitos de Empilhamento Z-Index: Dar a um cabeçalho fixo z-index: 999999, fazendo com que ele seja renderizado de forma estranha sobre sobreposições de fundo modal ou lightboxes em tela cheia.
  • Recorte do Indicador de Foco: Colocar elementos dentro de um container fixo com overflow: hidden, fazendo com que os anéis de foco nos links superior/inferior sejam cortados visualmente.

Critérios de Validação

  • O container do cabeçalho usa <header role="banner"> semântico com sub-navegação envolvida em <nav aria-label="...">.
  • O link "Pular para o Conteúdo Principal" está presente, é acessível como primeiro alvo de tabulação do teclado e se posiciona visivelmente sobre o cabeçalho fixo quando focado.
  • Elementos alvo de links de âncora internos definem scroll-margin-top igual ou superior à altura máxima do cabeçalho fixo.
  • A altura do cabeçalho fixo móvel não excede 64px, com barras superiores secundárias recolhidas na gaveta móvel.
  • Transições de estado de rolagem (encolher ou ocultar/revelar) usam propriedades CSS aceleradas por hardware (transform, opacity) e limitam cálculos de rolagem.
  • O contraste de texto e ícone em estados de fundo transparente, rolado ou desfocado (glass) satisfaz WCAG AA (≥4.5:1).
  • O empilhamento z-index adere à escala do sistema (Cabeçalho em z-index: 1000, abaixo de Modais e Gavetas).

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