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
  • Guida

    • Introduzione
    • Per iniziare
    • Requisiti di layout
    • Header dinamici
    • Come funziona
    • Risoluzione dei problemi
  • Framework

    • Vanilla JS
    • React
    • Vue
  • Riferimento

    • Riferimento API
    • Demo dal vivo

Per iniziare

Installazione

npm
npm i dynamic-sticky-sidebar
pnpm
pnpm add dynamic-sticky-sidebar
yarn
yarn add dynamic-sticky-sidebar
CDN
<script src="https://unpkg.com/dynamic-sticky-sidebar"></script>
<!-- exposes window.StickySidebar.stickySidebar -->

1. Imposta il layout della pagina

Metti la sidebar in una grid (o in un flex con direzione row) accanto al contenuto, e impedisci che si allunghi fino all'altezza dell'intera riga:

<header class="site-header">…</header>

<div class="layout">
    <aside id="sidebar">…</aside>
    <main>…</main>
</div>
.site-header {
    position: sticky;
    top: 0;
    z-index: 10;
}

.layout {
    display: grid;
    grid-template-columns: 280px 1fr;
    gap: 32px;
    align-items: start; /* important: the sidebar keeps its own height */
}

Perché la grid?

Un genitore grid o row-flex permette alla libreria di usare il comportamento sticky nativo in entrambe le direzioni. I layout block funzionano comunque, ma quando scorri verso l'alto entra in gioco un fallback in JS. Vedi Requisiti di layout.

2. Collega la sidebar

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

const sidebar = stickySidebar('#sidebar', {
    header: '.site-header',
    gap: 16,
    media: '(min-width: 768px)',
});

// later, e.g. when the page unmounts
sidebar.destroy();
React
import { StickySidebar } from 'dynamic-sticky-sidebar/react';

export function Layout({ children }) {
    return (
        <div className="layout">
            <StickySidebar header=".site-header" gap={16} media="(min-width: 768px)">
                …
            </StickySidebar>
            <main>{children}</main>
        </div>
    );
}
Vue
<script setup>
import { vStickySidebar } from 'dynamic-sticky-sidebar/vue';

const sticky = { header: '.site-header', gap: 16, media: '(min-width: 768px)' };
</script>

<template>
    <div class="layout">
        <aside v-sticky-sidebar="sticky">…</aside>
        <main><slot /></main>
    </div>
</template>

Tutto qui. Scorri verso il basso e la sidebar segue il contenuto fino alla sua fine, poi si blocca. Scorri verso l'alto e torna indietro, bloccandosi sotto l'header, ovunque si trovi l'header in quel momento.

3. Provala

Scorri dentro il riquadro qui sotto. La sub-nav scorre via quando scorri verso il basso e ricompare quando scorri verso l'alto, e la sidebar la segue.

Apri in una nuova scheda
Shopscorri dentro questo riquadro ↓
CategoriesBrandsDeals
Filter 1
Filter 2
Filter 3
Filter 4
Filter 5
Filter 6
Filter 7
Filter 8
Filter 9
Filter 10
Filter 11
Filter 12
Filter 13
Filter 14
Filter 15
Filter 16
Filter 17
Filter 18 (last)
Card 1
Card 2
Card 3
Card 4
Card 5
Card 6
Card 7
Card 8
Card 9
Card 10
Card 11
Card 12
Card 13
Card 14
Card 15
Card 16
Card 17
Card 18
Card 19
Card 20
Card 21
Card 22
Card 23
Card 24
footer

Prossimi passi

  • Requisiti di layout: grid, flex o block, e gli errori più comuni
  • Header dinamici: più header, header animati via JS e offset guidati dallo stato
  • Riferimento API: tutte le opzioni e i metodi dell'istanza
Modifica questa pagina su GitHub
Precedente
Introduzione
Successiva
Requisiti di layout