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

1.8 kB بعد الضغط بـ gzipبلا أي اعتمادياتTypeScript

الشريط الجانبي الذي يواكب الترويسة في صفحتك.

تثبيت لاصق في الاتجاهين للأشرطة الجانبية الأطول من الشاشة. يتبع الترويسات التي تنزلق خارج العرض أو تنطوي أو يتغيّر حجمها، ويعمل مع JavaScript الخالصة وReact وVue.

ابدأ الآن

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
مثبّت تحت الترويسة
مثبّت في الأسفل

العمود البرتقالي شريط جانبي للفلاتر، أطول من النافذة. يقع أعلاه مباشرة تحت الترويسة.

لماذا لا يكفي position: sticky وحده

حيث يقصّر sticky العادي

بعيد المنال

الأشرطة الجانبية الطويلة تُقتطع

يثبّت sticky العادي أعلى الشريط الجانبي الطويل، فتبقى عناصره الأخيرة بعيدة المنال حتى نهاية الصفحة.

→ يثبّت الأسفل أثناء النزول والأعلى أثناء الصعود.

فجوة فارغة

الترويسات المختفية تترك فراغًا

قيمة top الثابتة تناسب حالة واحدة للترويسة. حين تنزلق الترويسة بعيدًا، يبقى الشريط الجانبي في مكانه.

→ يتبع الحافة السفلية للترويسة في كل إطار طوال حركتها.

مغطّى

الترويسات المتمددة تغطيه

اللافتات وأشرطة البحث والأوضاع المصغّرة تغيّر ارتفاع الترويسة والصفحة مفتوحة.

→ يعيد القياس عند تغيّر الحجم أو الأصناف (class) أو الأنماط (style).

الإعداد

استدعاء دالة واحد، وقاعدة CSS واحدة

وجّه المكتبة إلى الشريط الجانبي والترويسة، وضع العمودين في شبكة (grid) لا تمدّ الشريط الجانبي. أما معالجة التمرير وتتبّع الترويسة والتنظيف فتتولاها المكتبة عنك.

خاصية position: sticky في المتصفح هي التي تحرّك الشريط الجانبي في كل إطار. ولا تغيّر المكتبة قواعد التثبيت إلا حين ينعكس اتجاه التمرير أو تتحرك الترويسة.

كيف تعمل ←

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

التوثيق

اقرأ بعد ذلك

التخطيطشبكة أو flex أو كتلي، وفخ overflow.الترويسات الديناميكيةصفوف متعددة ورسوم متحركة ومخازن حالة.مرجع APIكل خيار وكل دالة في النسخة.العرض الحيجرّب شريطًا جانبيًا طويلًا وقائمة تختفي تلقائيًا.
مرخّص بموجب رخصة MIT