كيف تعمل
معظم سكربتات الأشرطة الجانبية اللاصقة تحرّك الشريط الجانبي بـ 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 ولا يحدث شيء آخر.
الحالات الأربع
حين يكون الشريط الجانبي أطول من المساحة المتاحة، فإنه يتنقل بين أربع حالات:
- TOPمثبّت تحت الترويسة
top: max - DOWNتمرير ↓، يتحرك مع الصفحة
top: auto + margin-top - BOTTOMالحافة السفلية مثبّتة
top: min - UPتمرير ↑، يتحرك مع الصفحة
bottom + margin-bottom
| الحالة | قيد التثبيت | ما تراه |
|---|---|---|
| TOP | top: max | مثبّت تحت الترويسة |
| DOWN | top: auto + إزاحة margin-top | يتحرك مع الصفحة في طريقه لأسفل |
| BOTTOM | top: min | الحافة السفلية مثبّتة بأسفل منفذ العرض |
| UP | bottom: … + إزاحة 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) فقط. مستمع التمرير سلبي، ولا يفعل سوى جدولة إطار.