dynamic-sticky-sidebardynamic-sticky-sidebar
Leitfaden
  • Vanilla JS
  • React
  • Vue
API
Demo
npm
  • English
  • فارسی
  • العربية
  • Deutsch
  • Français
  • Italiano
GitHub
Leitfaden
  • Vanilla JS
  • React
  • Vue
API
Demo
npm
  • English
  • فارسی
  • العربية
  • Deutsch
  • Français
  • Italiano
GitHub

1,8 kB gzip0 AbhängigkeitenTypeScript

Die Sidebar, die mit deinem Header Schritt hält.

Sticky-Positionierung in beide Richtungen für Sidebars, die höher als der Bildschirm sind. Sie folgt Headern, die wegrutschen, einklappen oder ihre Größe ändern – mit reinem JS, React und Vue.

Loslegen

Vanilla JSReactVue

TrailheadSearch gearCart (2)
CampHikeClimbSale

Category

Brand

Season

Weight

Rating

Apply filters
Ridgeline 2P tent$389
Alder 45 L pack$210
Cinder –5° bag$265
Pocket stove kit$64
Northpass trail runner$148
Lumen 400 headlamp$52
Kestrel 1P bivy$174
Merino base layer$89
Folding trekking poles$118
Lowland camp chair$72
Insulated mug, 350 ml$28
Repair kit$19
Free returns within 60 days
Unter dem Header fixiert
Unten fixiert

Die orange Spalte ist eine Filter-Sidebar, höher als das Fenster. Ihr oberer Rand sitzt direkt unter dem Header.

Warum nicht einfach position: sticky

Wo reines Sticky an seine Grenzen stößt

unerreichbar

Hohe Sidebars werden abgeschnitten

Reines Sticky fixiert den oberen Rand einer langen Sidebar. Ihre letzten Einträge bleiben unerreichbar, bis die Seite endet.

→ Fixiert beim Runterscrollen den unteren Rand und beim Hochscrollen den oberen.

leere Lücke

Verschwindende Header hinterlassen eine Lücke

Ein fester top-Wert passt nur zu einem Header-Zustand. Rutscht der Header weg, bleibt die Sidebar, wo sie war.

→ Folgt dem unteren Rand des Headers in jedem Frame, solange er sich bewegt.

verdeckt

Wachsende Header verdecken sie

Banner, Suchleisten und Kompaktmodi ändern die Header-Höhe, während die Seite offen ist.

→ Misst bei Größen-, Klassen- und Style-Änderungen neu.

Einrichtung

Ein Funktionsaufruf, eine CSS-Regel

Übergib die Sidebar und den Header. Setze beide Spalten in ein Grid, das die Sidebar nicht streckt. Scroll-Handling, Header-Tracking und Aufräumen übernimmt die Bibliothek.

Das browsereigene position: sticky bewegt die Sidebar in jedem Frame. Die Bibliothek ändert die Sticky-Regeln nur, wenn sich die Scrollrichtung umkehrt oder der Header bewegt.

So funktioniert es →

Vanilla
import { stickySidebar } from 'dynamic-sticky-sidebar';

stickySidebar('#sidebar', {
    header: '.site-header',
    media: '(min-width: 768px)',
});
React
import { StickySidebar } from 'dynamic-sticky-sidebar/react';

<StickySidebar header=".site-header" media="(min-width: 768px)">
    <Filters />
</StickySidebar>
Vue
<script setup>
import { vStickySidebar } from 'dynamic-sticky-sidebar/vue';
const sticky = { header: '.site-header', media: '(min-width: 768px)' };
</script>

<template>
    <aside v-sticky-sidebar="sticky"><Filters /></aside>
</template>
.layout {
    display: grid;
    grid-template-columns: 280px 1fr;
    align-items: start; /* keep the sidebar at its own height */
}

Dokumentation

Weiterlesen

LayoutGrid, Flex oder Block – und die Overflow-Falle.Dynamische HeaderMehrere Zeilen, Animationen und Stores.API-ReferenzAlle Optionen und Instanzmethoden.Live-DemoHohe Sidebar und automatisch ausblendende Navigation zum Ausprobieren.
MIT-Lizenz