Communitygithub.com

Sticky Header & Top Bar System

Entwerfen, Strukturieren und Optimieren von klebrigen und fixierten Top-Bar-Systemen – einschließlich Ankündigungsbalken, Utility-Headern, primären Navigations-Headern, Schrumpf-beim-Scroll-Verhalten, dynamischen Ein-/Ausblend-Scrollmustern, Höhenübergängen und WCAG-AA-Barrierefreiheit.

Was ist Sticky Header & Top Bar System?

Das Sticky-Header- und Top-Bar-System bietet ein umfassendes Framework für die Gestaltung, Strukturierung und Verhaltenskonfiguration von persistenten Navigations-Stapeln am oberen Seitenrand. Moderne Webanwendungen und Marketingseiten nutzen häufig mehrschichtige Top-Bars – aus Werbebannern, sekundären Utility-Links und primären Navigationsleisten. Diese Skill adressiert typische Probleme wie übermäßigen Platzverbrauch auf mobilen Geräten, Überlappungen von Ankerzielen, Layout-Ruckler während Scroll-Statusänderungen, Z-Index-Konflikte und fehlende Barrierefreiheit. Die Lösung unterstützt verschiedene Scroll-Verhalten (immer klebrig, schrumpfend, dynamisch versteckend) und Plattformen wie E-Commerce, SaaS-Marketing, Content-Portale und Web-Apps. Die Implementierung erfolgt über semantisches HTML, CSS Custom Properties, scroll-schonende JavaScript-Listener und WCAG-AA-konforme Skip-Links sowie Anker-Kompensation.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Sticky-Header- und Top-Bar-System

Zweck

Das Sticky-Header- und Top-Bar-System bietet ein umfassendes Framework für die Gestaltung, Strukturierung und Verhaltenskonfiguration von persistenten Navigations-Stapeln am oberen Seitenrand. Moderne Webanwendungen und Marketingseiten nutzen häufig mehrschichtige Top-Bars – eine Kombination aus Werbebannern, sekundären Utility-Links (Währungs-/Sprachauswahl, Support-Links, Store-Locator) und primären Navigationsleisten.

Wenn diese Balken beim Scrollen fixiert oder klebrig bleiben, führen schlecht architektonierte Systeme zu kritischen Usability-Problemen: übermäßiger vertikaler Viewport-Verbrauch auf mobilen Geräten, Überlappung von Ankerziel-Inhalten („scroll-margin-top“-Fehler), Layout-Ruckler oder Stottern bei Scroll-Statusänderungen, Z-Index-Konflikte mit Modals oder Dropdowns sowie eingeklemmter Tastaturfokus oder fehlerhafte Screenreader-Landmarken-Navigation. Diese Skill etabliert Standards für Design, räumliche Komposition, Scroll-Status-Logik, Höhenstyling und Barrierefreiheit für Sticky-Header.

Anwendungsfälle

  • E-Commerce-Global-Header: Mehrschichtige Top-Bars aus oberen Ankündigungsbannern (Rabattcode / Versandfortschritt), Utility-Links (Konto-Login, Regionsauswahl, Store-Locator) und der Haupt-Sticky-Navigation mit Suchleiste und Warenkorb-Badge.
  • SaaS-Marketing- & Produkt-Marketing-Header: Saubere Primär-Header, die beim Scrollen schrumpfen (Reduzierung von Padding/Logo-Größe) oder dynamisch beim Scrollen nach unten versteckt / nach oben eingeblendet werden, um den vertikalen Inhaltsbereich zu maximieren und gleichzeitig den schnellen Navigationszugriff zu erhalten.
  • Content-Portale & Publikations-Header: Sticky-Header mit integrierten Lesefortschrittsbalken, Kategorienavigation, Artikeltitel-Anzeigen und Schnell-Lesezeichen-/Teilen-Floating-Tools.
  • Webanwendungen & SaaS-App-Shells: Fixierte Top-Bars mit Breadcrumbs, aktiven Workspace-Wechslern, Befehlssuche-Triggern, Benutzerprofilmenüs und Echtzeit-Benachrichtigungsglocken.

Wann NICHT verwenden

  • In-Canvas-Formatierungssymbolleisten: Für Toolbars von Rich-Text-Editoren oder Bulk-Action-Docks, die über Inhalten schweben oder an bestimmte Editor-Komponenten gebunden sind, verwenden Sie toolbar-and-action-dock-system.
  • Mobile Bottom-Navigationsleisten: Für primäre mobile App-Tabs, die am unteren Rand des mobilen Viewports fixiert sind, verwenden Sie bottom-navigation-system.
  • Vollständige Seiten-Navigations-Shells: Für komplexe SaaS-Webanwendungen, bei denen die primäre Navigation über eine einklappbare linke Seitenleiste erfolgt, verwenden Sie sidebar-navigation-system.
  • Floating-Action-Docks: Für schwebende kontextuelle Buttons, die an Viewport-Ecken fixiert sind (z. B. Chat-Widgets, Back-to-Top-FABs), verwenden Sie sticky-and-floating-ui-system.

Eingaben

  1. Top-Bar-Ebenen-Architektur: Spezifikation der vorhandenen Ebenen (z. B. Ebene 1: Ankündigungsbalken, Ebene 2: Utility-Header, Ebene 3: Primäre Navigation).
  2. Scroll-Verhaltensmodell: Gewünschte Sticky-Mechanik (sticky-always, shrink-on-scroll, hide-on-scroll-down / reveal-on-scroll-up oder static-to-sticky).
  3. Oberflächen- & Design-Token: Hintergrundflächenfarben, Rand-Token, Backdrop-Blur-Effekte (backdrop-filter: blur()) und Höhenschatten aus elevation-and-depth-system und accessible-color-system.
  4. Viewport- & Geräteziele: Breakpoint-Schwellenwerte (< 768px, < 1024px, ≥ 1024px) zum Zusammenfalten mehrschichtiger Desktop-Header in einheitliche mobile Top-Bars.

Ausgaben

  1. Sticky-Header-Layout- & Stapel-Spezifikation: CSS-Grid/Flexbox-Strukturen, die eine fixierte/klebrige Positionierung definieren, CSS-Custom-Property-Offset-Variablen (--header-height) und Z-Index-Hierarchieskalen.
  2. Scroll-Status-Übergangs- & Bewegungsregeln: Technische Spezifikation für Scroll-Listener-Logik, Schwellenwert-Offsets, CSS-Übergangsklassen (.is-scrolled, .is-hidden) und hardwarebeschleunigte Transforms (transform: translateY()).
  3. Responsive Mobile Collapse-Spezifikation: Layout-Regeln, die mehrzeilige Desktop-Top-Bars in einen einzigen, kompakten mobilen Header mit Drawer-Umschalter umwandeln.
  4. WCAG-AA-Barrierefreiheits-Blaupause: Skip-Link-Implementierung (.skip-link), scroll-margin-top-Offset-Kompensation für Ankerziele von Überschriften, Vermeidung von Tastaturfokus-Fallen und Screenreader-Landmarken-Struktur (<header>, <nav>, role="banner").

Arbeitsablauf

1. Struktur der Top-Bar-Stapelhierarchie

Bestimmen Sie die Zusammensetzung der mehrschichtigen Top-Bar und erstellen Sie ein semantisches HTML-Layout:

  • Semantischer HTML-Container: Umfassen Sie alle Top-Bars innerhalb eines einzigen <header role="banner">-Tags, um eine klare Banner-Landmarke für Screenreader-Nutzer zu erhalten.
  • Ebene 1: Ankündigungsbalken (<aside> oder <div>): Hochprioritärer Mikro-Banner ganz oben (z. B. Versandkostenfrei-Schwelle, Systemwarnung).
  • Ebene 2: Utility-Bar (<div class="utility-bar">): Sekundäre Links, Sprach-/Währungsauswahl, Kontaktlinks, Kundensupport.
  • Ebene 3: Primäre Navigation (<nav aria-label="Main Navigation">): Markenlogo, primäre Rubrik-Links, Suchfeld, Kontolink, Einkaufswagen oder primärer CTA.

2. Positionierung & Scroll-Mechanik definieren

Wählen Sie den Sticky-Implementierungsansatz basierend auf Inhaltsdichte und Viewport-Einschränkungen:

  • position: sticky vs position: fixed:
    • Bevorzugen Sie position: sticky; top: 0; z-index: 1000; am Container, wenn der natürliche Dokumentenfluss vor dem Einrasten am oberen Rand ermöglicht werden soll.
    • Verwenden Sie position: fixed; top: 0; left: 0; right: 0;, wenn der Body-Inhalt explizit padding-top: var(--header-height); verwendet.
  • Mehrschichtige Scroll-Collapse-Strategie:
    • Beim Scrollen über einen Schwellenwert (z. B. scrollY > 50px) scrollen der Ankündigungsbalken und die Utility-Bar natürlich aus dem Blickfeld, während die primäre Navigation einrastet (position: sticky; top: 0;) ODER der gesamte Header übergeht.
    • Berechnen Sie CSS-Custom-Properties dynamisch (z. B. --header-height), damit Hauptseiteninhalte und Ankerlinks korrekt angepasst werden.

3. Scroll-Status-Übergänge & Mikro-Interaktionen implementieren

Verbessern Sie die Header-Ergonomie, während der Benutzer auf der Seite nach unten scrollt:

  • Schrumpf-beim-Scroll-Übergang:
    • Standardzustand (oben): Header-Höhe 80px, Logo-Höhe 40px, Padding 1.25rem 2rem.
    • Gescrollter Zustand (.is-scrolled): Header-Höhe 60px, Logo-Höhe 30px, Padding 0.75rem 2rem.
    • Sanfte Animation: Verwenden Sie hardwarebeschleunigte CSS-Übergänge (transition: padding 0.25s ease, height 0.25s ease, background-color 0.25s ease, box-shadow 0.25s ease;).
  • Dynamisches Ein-/Ausblenden (Smart Header):
    • Scrollen nach unten (scrollY > lastScrollY && scrollY > 150px): Wenden Sie transform: translateY(-100%); an, um den Header auszublenden und den Lese-Viewport zu maximieren.
    • Scrollen nach oben (scrollY < lastScrollY): Wenden Sie transform: translateY(0); an, um die Navigation sofort einzublenden.
  • Oberflächenhöhe & Backdrop-Blur:
    • Oben auf der Seite: Hintergrund halbtransparent oder flacher Hintergrund ohne Schatten.
    • Beim Scrollen: Fügen Sie eine feste / glasmorphe Oberfläche hinzu (background-color: rgba(255, 255, 255, 0.85); backdrop-filter: blur(12px);) und einen Höhenschatten (box-shadow: 0 4px 20px rgba(0, 0, 0, 0.08);).

4. Mobile Viewport-Anpassung konfigurieren

Mobile Viewports (< 768px) haben stark eingeschränkten vertikalen Platz:

  • Mobile Header-Höhenobergrenze: Begrenzen Sie die mobile Sticky-Header-Höhe auf maximal 56px–64px, um zu vermeiden, dass mehr als 10 % der mobilen Bildschirmhöhe belegt werden.
  • Mobile Ebenenreduzierung: Verstecken Sie sekundäre Utility-Bars auf mobilen Geräten und verschieben Sie Utility-Links in den einklappbaren mobilen Navigations-Drawer.
  • Ankündigungsbalken-Konsolidierung: Komprimieren Sie den Ankündigungstext zu prägnantem Mikro-Text oder einem automatisch rotierenden Ticker, oder lassen Sie ihn statisch über dem klebrigen Haupt-Header.

5. WCAG-AA-Barrierefreiheit & Fokus-Management umsetzen

  • Skip to Main Content Link: Stellen Sie einen Skip-Link auf oberster Ebene als allererstes fokussierbares Element bereit (<a href="#main-content" class="skip-link">Zum Hauptinhalt springen</a>). Wenn er über Tab fokussiert wird, positionieren Sie ihn sichtbar über dem Sticky-Header (top: 1rem; left: 1rem; z-index: 9999;).
  • Ankerziel-Scroll-Margin (scroll-margin-top): Verhindern Sie, dass Sticky-Header mit Überschriften überlappen, wenn Benutzer auf interne Ankerlinks oder Inhaltsverzeichnis-Elemente klicken:
    :target, [id] {
      scroll-margin-top: calc(var(--header-height) + 1.5rem);
    }
    
  • Tastaturnavigation & Dropdowns: Stellen Sie sicher, dass alle Header-Dropdowns (Mega-Menüs, Kontomenüs, mobiler Hamburger-Umschalter) vollständig über Tab, Enter, Leertaste und Escape bedienbar sind.
  • Prefers-Reduced-Motion: Respektieren Sie die Bewegungseinstellungen der Benutzer, indem Sie gleitende Transforms und Layout-Übergänge deaktivieren:
    @media (prefers-reduced-motion: reduce) {
      .site-header { transition: none !important; }
    }
    

Entscheidungsregeln

Auswahlmatrix für Sticky-Scroll-Mechaniken

SeitentypEmpfohlenes Scroll-VerhaltenMobile AnpassungBegründung
E-Commerce-ShopSticky Main Nav + Statische Top-BarsTop-Promo-Bar scrollt weg; Haupt-Navigation bleibt klebrig (56px)Hält Suche, Warenkorb und Kategorien jederzeit zugänglich, um die Konversion zu maximieren.
SaaS-Landing / MarketingSchrumpf-beim-Scroll oder Smart Hide/RevealEinheitlicher 60px-Header; versteckt beim Runter-, zeigt beim HochscrollenMaximiert den visuellen Helden-Bereich und den Leseplatz, bei sofortigem Navigationszugriff bei Bedarf.
Content-Blog / RedaktionellSmart Hide/Reveal mit LesefortschrittKompakte Top-Bar mit FortschrittsbalkenGibt 100 % des Viewports für lange Leseinhalte frei, kehrt beim Rückscrollen sofort zur Navigation zurück.
Web-App / DashboardImmer sichtbarer Fix-HeaderFixierter einzeiliger Header (56px)Fungiert als App-Utility-Shell; dynamisches Ausblenden würde während des Arbeitsablaufs desorientieren.

Z-Index-Ebenen-Skala

Halten Sie eine strenge Z-Index-Orchestrierung im gesamten globalen Designsystem ein:

z-index: 10000; -> Skip to Content Link (bei Fokus)
z-index: 9000;  -> Modal-Dialoge / Lightboxen
z-index: 8000;  -> Mobile Nav Drawer / Overlay
z-index: 7000;  -> Globale Toast- & Benachrichtigungsbanner
z-index: 1000;  -> Sticky / Fixed Top Header Stack
z-index: 500;   -> Kontextuelle Toolbars & Floating Docks
z-index: 1;     -> Stapelkontext von Content Cards

Einschränkungen

  • Barrierefreiheit (WCAG 2.1 AA):
    • SC 2.4.1 Blöcke umgehen: Muss einen sichtbaren Skip to Main Content Link vor der Header-Navigation enthalten.
    • SC 1.4.3 Kontrast: Header-Text, -Symbole und -Menü-Trigger müssen ein minimales Kontrastverhältnis von 4,5:1 sowohl im gescrollten als auch im ungescrollten Header-Zustand erfüllen.
    • SC 2.4.7 Fokus sichtbar: Fokus-Indikatoren müssen vollständig sichtbar und nicht abgeschnitten bleiben, wenn durch Sticky-Header-Elemente über beliebige Hintergrundfarben getabbt wird.
  • Leistung & Rendering:
    • Scroll-Listener müssen gedrosselt oder über requestAnimationFrame oder IntersectionObserver gebunden werden, um erzwungene synchrone Layout-Thrashing bei Scroll-Ereignissen zu vermeiden.
    • Blur-Filter (backdrop-filter) müssen sorgfältig eingegrenzt und auf GPU-Verzögerungen auf leistungsschwächeren mobilen Geräten getestet werden.
  • Viewport-Layout-Schutz: Sticky-Header auf mobilen Geräten dürfen 64px Höhe oder 15 % der Höhe des visuellen Viewports im klebrigen Zustand nicht überschreiten.

Häufige Fehlermuster

  • Anker-Inhaltsüberlappungsfehler: Klicken auf einen internen Link (#section-2) scrollt die Rubrik-Überschrift direkt unter den Sticky-Header, sodass der Titel unsichtbar wird, weil scroll-margin-top fehlt.
  • Viewport-Bildschirm-Hogging: Beibehalten eines 140px mehrschichtigen Desktop-Headers auf mobilen Bildschirmen, sodass weniger als 60 % des mobilen Bildschirms für den tatsächlichen Seiteninhalt sichtbar bleiben.
  • Scroll-Layout-Thrashing: Abfragen von header.offsetHeight innerhalb eines ungedrosselten window.onscroll-Listeners, was zu Layout-Thrashing und ruckeligem 30fps-Scrolling führt.
  • Z-Index-Stapelkonflikte: Vergeben von z-index: 999999 an einen Sticky-Header, der dann unschön über Modal-Hintergrund-Overlays oder Vollbild-Lightboxen gerendert wird.
  • Fokus-Indikator-Clipping: Platzieren von Elementen in einem fixierten Container mit overflow: hidden, sodass Fokusringe an oberen/unteren Links visuell abgeschnitten werden.

Validierungskriterien

  • Header-Container verwendet semantisches <header role="banner"> mit Sub-Navigation in <nav aria-label="...">.
  • Skip to Main Content Link ist vorhanden, als erstes Tastatur-Tab-Ziel erreichbar und positioniert sich bei Fokus sichtbar über dem Sticky-Header.
  • Ziel-Elemente interner Ankerlinks setzen scroll-margin-top gleich oder größer als die maximale Sticky-Header-Höhe.
  • Mobile Sticky-Header-Höhe überschreitet 64px nicht, sekundäre Top-Bars sind in den mobilen Drawer eingeklappt.
  • Scroll-Status-Übergänge (Schrumpfen oder Ein-/Ausblenden) verwenden hardwarebeschleunigte CSS-Eigenschaften (transform, opacity) und drosseln Scroll-Berechnungen.
  • Text- und Symbolkontrast über transparente, gescrollte oder verschwommene Glas-Zustände hinweg erfüllt WCAG AA (≥4,5:1-Verhältnis).
  • Z-Index-Ebenen folgen der Systemskala (Header bei z-index: 1000, unterhalb von Modals und Drawern).

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.

Verwandte Skills