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
    • العرض الحي

كيف تعمل

معظم سكربتات الأشرطة الجانبية اللاصقة تحرّك الشريط الجانبي بـ transform أو top عند كل حدث تمرير. ولأن أحداث التمرير تصل بعد أن يكون المتصفح قد مرّر الصفحة فعلًا، يتأخر الشريط الجانبي دائمًا بإطار ويهتز. تتبع هذه المكتبة النهج المعاكس: خاصية position: sticky في المتصفح تؤدي العمل في كل إطار، ولا تغيّر JS إلا القواعد.

موضعا التثبيت

عند كل تحديث، تحسب المكتبة موضعين للحافة العلوية للشريط الجانبي، بالنسبة إلى منفذ العرض (أو حاوية التمرير):

max = header bottom + offsetTop + gap        // pinned under the header
min = viewport height − sidebar height − offsetBottom − gap   // bottom aligned

إذا كان الشريط الجانبي يتسع (max − min < 1px)، فإنه يُثبَّت ببساطة عند top: max ولا يحدث شيء آخر.

الحالات الأربع

حين يكون الشريط الجانبي أطول من المساحة المتاحة، فإنه يتنقل بين أربع حالات:

  1. TOPمثبّت تحت الترويسةtop: max
  2. DOWNتمرير ↓، يتحرك مع الصفحةtop: auto + margin-top
  3. BOTTOMالحافة السفلية مثبّتةtop: min
  4. UPتمرير ↑، يتحرك مع الصفحةbottom + margin-bottom
الحالةقيد التثبيتما تراه
TOPtop: maxمثبّت تحت الترويسة
DOWNtop: auto + إزاحة margin-topيتحرك مع الصفحة في طريقه لأسفل
BOTTOMtop: minالحافة السفلية مثبّتة بأسفل منفذ العرض
UPbottom: … + إزاحة margin-bottomيتحرك مع الصفحة في طريقه لأعلى

لا تحدث الانتقالات إلا حين ينعكس اتجاه التمرير أو يبلغ الشريط الجانبي إحدى الحافتين. التمرير لأسفل ينقله من TOP مرورًا بـ DOWN إلى BOTTOM. والتمرير لأعلى ينقله من BOTTOM مرورًا بـ UP عائدًا إلى TOP.

عكس الاتجاه في منتصف الطريق (DOWN ↔ UP) يحرّر الشريط الجانبي مجددًا من موضعه الحالي أيًّا كان، فلا يقفز أبدًا.

حين يكون الشريط الجانبي "محرَّرًا" (DOWN / UP)، تضبط المكتبة top/bottom على auto وتضيف هامشًا يساوي المسافة الحالية بين الشريط الجانبي وموضعه الطبيعي. فيبقى الشريط في مكانه على الشاشة تمامًا، ومن ثم يتحرك مع تمرير الصفحة بشكل أصلي. وحين يبلغ الحافة الأخرى، يتولى التثبيت الأصلي في المتصفح الأمر من جديد، وتكتفي المكتبة بتسجيل الحالة الجديدة.

لماذا grid أو flex

لتحرير الشريط الجانبي باتجاه الأعلى، يجب أن يكون مرتكزًا إلى أسفل حاويته. في أب من نوع grid أو flex صفّي، تضبط المكتبة align-self: flex-end مع هامش سفلي، فيُمرَّر الشريط الجانبي لأعلى بشكل أصلي.

أما في التدفق الكتلي فلا توجد طريقة لمحاذاة عنصر إلى الأسفل، لذا تلجأ المكتبة إلى حساب top بـ JS أثناء التمرير لأعلى. راجع متطلبات التخطيط.

تتبّع الترويسة

حين تتحرك الترويسة، تتغير قيمة max. في حالة TOP تكتب المكتبة قيمة top الجديدة فورًا، فيتحرك الشريط الجانبي مع الترويسة.

ولأن الرسوم المتحركة للترويسة قد تجري دون أي تمرير، تبدأ المكتبة حلقة requestAnimationFrame قصيرة كلما احتمل أن شيئًا ما يتحرك:

  • تمرير، أو تغيّر حجم، أو استدعاء ResizeObserver؛
  • حدث transitionrun / animationstart أو تغيّر في سمة على إحدى الترويسات.

تعيد الحلقة الحساب في كل إطار ما دامت قيمة max تتغير أو كانت هناك رسوم متحركة محدودة تجري على إحدى الترويسات، وتتوقف من تلقاء نفسها بعد 3 إطارات خاملة من استقرار كل شيء. لا يجري أي شيء حين تكون الصفحة خاملة.

تفاصيل صغيرة

  • لا يُكتب إلا التغيير الحقيقي. تُقارَن top وbottom بآخر قيمة مكتوبة قبل المساس بـ DOM، وتُقرَّب القيم إلى 0.01px.
  • تثبيت التمرير (scroll anchoring) معطَّل على الشريط الجانبي (overflow-anchor: none) كي لا يتعارض المتصفح مع تعديلات الهامش.
  • تغيّرات حجم الشريط الجانبي (تحميل محتوى، فتح أكورديون) يلتقطها ResizeObserver. ويُعاد ارتكاز الشريط المحرَّر عند موضعه الحالي على الشاشة.
  • مستمعات سلبية (passive) فقط. مستمع التمرير سلبي، ولا يفعل سوى جدولة إطار.
عدّل هذه الصفحة على GitHub
السابق
الترويسات الديناميكية
التالي
استكشاف الأخطاء وإصلاحها