dynamic-sticky-sidebardynamic-sticky-sidebar
الدليل
  • JavaScript الخالصة
  • React
  • Vue
API
العرض الحي
npm
  • English
  • فارسی
  • العربية
  • Deutsch
  • Français
  • Italiano
GitHub
الدليل
  • JavaScript الخالصة
  • React
  • Vue
API
العرض الحي
npm
  • English
  • فارسی
  • العربية
  • Deutsch
  • Français
  • Italiano
GitHub
  • الدليل

    • مقدمة
    • البدء
    • متطلبات التخطيط
    • الترويسات الديناميكية
    • كيف تعمل
    • استكشاف الأخطاء وإصلاحها
  • أطر العمل

    • JavaScript الخالصة
    • React
    • Vue
  • المرجع

    • مرجع API
    • العرض الحي

البدء

التثبيت

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. تخطيط الصفحة

ضع الشريط الجانبي بجانب المحتوى داخل شبكة (grid) (أو flex باتجاه صفّي)، وامنعه من التمدد إلى ارتفاع الصف كاملًا:

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

لماذا الشبكة؟

يتيح الأب من نوع grid أو flex صفّي للمكتبة أن تستخدم سلوك التثبيت الأصلي في الاتجاهين. التخطيطات الكتلية تعمل أيضًا، لكن التمرير لأعلى يعتمد حينها على حل بديل بـ JS. راجع متطلبات التخطيط.

2. ربط الشريط الجانبي

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>

هذا كل شيء. مرّر لأسفل، وسيتبع الشريط الجانبي المحتوى حتى نهايته ثم يلتصق. مرّر لأعلى، وسيعود ويلتصق تحت الترويسة أينما كانت في تلك اللحظة.

3. جرّبها

مرّر داخل المربع أدناه. تنزلق القائمة الفرعية بعيدًا عند التمرير لأسفل وتعود عند التمرير لأعلى، والشريط الجانبي يتبعها.

فتح في علامة تبويب جديدة
Shopمرّر داخل هذا المربع ↓
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

الخطوات التالية

  • متطلبات التخطيط: grid مقابل flex مقابل التخطيط الكتلي، والأخطاء الشائعة
  • الترويسات الديناميكية: ترويسات متعددة، وترويسات تحرّكها JS، وإزاحات مستمدة من الحالة
  • مرجع API: كل الخيارات ودوال النسخة
عدّل هذه الصفحة على GitHub
السابق
مقدمة
التالي
متطلبات التخطيط