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

1.8 kB gzip0 dipendenzeTypeScript

La sidebar che tiene il passo con il tuo header.

Posizionamento sticky bidirezionale per sidebar più alte dello schermo. Segue gli header che scorrono via, si comprimono o cambiano dimensione, e funziona con JS puro, React e Vue.

Inizia

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
Bloccata sotto l'header
Bloccata in fondo

La colonna arancione è una sidebar di filtri, più alta della finestra. La sua cima si trova subito sotto l'header.

Perché non basta position: sticky

Dove il semplice sticky non basta

irraggiungibile

Le sidebar alte vengono tagliate

Lo sticky semplice blocca la parte alta di una sidebar lunga, così gli ultimi elementi restano irraggiungibili fino alla fine della pagina.

→ Blocca il fondo mentre scorri verso il basso e la cima mentre scorri verso l'alto.

spazio vuoto

Gli header a scomparsa lasciano un vuoto

Un valore top fisso va bene per un solo stato dell'header. Quando l'header scorre via, la sidebar resta dov'era.

→ Segue il bordo inferiore dell'header a ogni frame mentre si muove.

coperta

Gli header che crescono la coprono

Banner, barre di ricerca e modalità compatte cambiano l'altezza dell'header mentre la pagina è aperta.

→ Rimisura tutto quando cambiano dimensioni, classi e stili.

Configurazione

Una chiamata di funzione, una regola CSS

Indica la sidebar e l'header. Metti le due colonne in una grid che non allunga la sidebar. Alla gestione dello scroll, al tracciamento dell'header e alla pulizia finale ci pensa la libreria.

Il position: sticky nativo del browser sposta la sidebar a ogni frame. La libreria cambia le regole sticky solo quando si inverte la direzione di scroll o quando l'header si muove.

Come funziona →

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

Documentazione

Da leggere dopo

LayoutGrid, flex o block, e la trappola dell'overflow.Header dinamiciPiù righe, animazioni e store.Riferimento APITutte le opzioni e i metodi dell'istanza.Demo dal vivoAttiva una sidebar alta e una nav a scomparsa.
Licenza MIT