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

1,8 kB gzippé0 dépendanceTypeScript

La barre latérale qui suit votre en-tête.

Un positionnement sticky bidirectionnel pour les barres latérales plus hautes que l'écran. Elle suit les en-têtes qui disparaissent, se replient ou changent de taille, et fonctionne avec du JS natif, React et Vue.

Commencer

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
Fixée sous l'en-tête
Fixée en bas

La colonne orange est une barre latérale de filtres, plus haute que la fenêtre. Son haut se trouve juste sous l'en-tête.

Pourquoi pas simplement position: sticky

Là où le sticky classique ne suffit pas

hors d'atteinte

Les barres latérales hautes sont coupées

Le sticky classique fixe le haut d'une longue barre latérale : ses derniers éléments restent hors d'atteinte jusqu'à la fin de la page.

→ Fixe le bas en descendant et le haut en remontant.

vide

Les en-têtes masqués laissent un vide

Une valeur top fixe ne convient qu'à un seul état de l'en-tête. Quand l'en-tête disparaît, la barre latérale reste où elle était.

→ Suit le bord inférieur de l'en-tête à chaque frame pendant qu'il bouge.

recouverte

Les en-têtes qui grandissent la recouvrent

Bannières, barres de recherche et modes compacts modifient la hauteur de l'en-tête pendant que la page est ouverte.

→ Remesure à chaque redimensionnement et à chaque changement de classe ou de style.

Mise en place

Un appel de fonction, une règle CSS

Indiquez la barre latérale et l'en-tête, puis placez les deux colonnes dans une grille qui n'étire pas la barre latérale. La gestion du défilement, le suivi de l'en-tête et le nettoyage sont pris en charge pour vous.

C'est le position: sticky natif du navigateur qui déplace la barre latérale à chaque frame. La bibliothèque ne modifie les règles sticky que lorsque le sens du défilement s'inverse ou que l'en-tête bouge.

Comment ça marche →

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 */
}

Documentation

À lire ensuite

Mise en pageGrid, flex ou bloc, et le piège d'overflow.En-têtes dynamiquesPlusieurs rangées, animations et stores.Référence de l'APIToutes les options et méthodes d'instance.Démo en directActivez une barre latérale haute et une navigation qui se masque.
Sous licence MIT