استكشاف الأخطاء وإصلاحها
نصيحة
لا تظهر تحذيرات وحدة التحكم أدناه إلا في بناءات التطوير. أما بناءات الإنتاج وبناء CDN فتحذفها توفيرًا للحجم.
الشريط الجانبي لا يلتصق إطلاقًا
- إنه متمدد. في grid/flex يأخذ الشريط الجانبي افتراضيًا ارتفاع الصف كاملًا. أضف
align-items: startإلى العنصر الأب أوalign-self: startإلى الشريط الجانبي. راجع التخطيط. - أحد الأسلاف مضبوط عليه
overflow. وجودoverflow: hidden | auto | scrollعلى أي عنصر سلف يجعله حاوية التثبيت. استخدمoverflow: clip، أو مرّر ذلك العنصر فيscrollerإن كان هو حاوية التمرير الفعلية. mediaلا يطابق. تبقى النسخة غير نشطة ما دام استعلام الوسائط غير متحقق.- يبدأ مخفيًا. إذا لم يكن للشريط الجانبي ارتفاع عند البدء (
display: none، أو داخل تبويب مغلق)، فإن النسخة تنتظر. يلتقطهResizeObserverحين يصبح ظاهرًا، أو استدعِupdate().
خطأ "element not found"
ترمي stickySidebar('#sidebar') خطأً حين لا يطابق المحدِّد أي عنصر. أنشئ النسخة بعد أن يصبح العنصر في DOM: بعد DOMContentLoaded، أو داخل onMounted / useEffect، أو استخدم محوّلات أطر العمل التي تتولى ذلك عنك.
محدِّد الترويسة لم يطابق شيئًا
[dynamic-sticky-sidebar] header selector ".site-header" matched no elements
لم يعثر محدِّد header على شيء حين بدأت النسخة، لذا يُثبَّت الشريط الجانبي بأعلى منفذ العرض وقد ينزلق تحت الترويسة. تحقق من المحدِّد، أو استدعِ refresh() بعد أن تُعرض الترويسة.
لم يُعثر على حاوية التمرير
[dynamic-sticky-sidebar] scroller "#app" not found, using the window
لم يُحَل الخيار scroller إلى عنصر. تحقق من المحدِّد، أو مرّر العنصر نفسه.
تحذير في وحدة التحكم بشأن grid / row-flex
[dynamic-sticky-sidebar] parent is not grid / row-flex, so scrolling up uses a JS fallback …
الأب المباشر للشريط الجانبي عنصر كتلي. الأمور تعمل مع ذلك، لكن التمرير لأعلى قد يتأخر إطارًا. أعطِ العنصر الأب display: grid; align-items: start. راجع التخطيط الكتلي.
الشريط الجانبي يتداخل مع الترويسة أو يترك فراغًا تحتها
- تأكد من تمرير كل صفوف الترويسة في
header. عند استخدام محدِّد، تُستخدم كل العناصر المطابقة. - إذا كانت الترويسة تتحرك بسبب صنف (class) على عنصر سلف، فلا تستطيع المكتبة رؤية ذلك. استدعِ
update()، أو استخدمsubscribe. - الترويسات المستبدَلة في DOM بعد البدء تحتاج إلى
refresh(). - تريد مساحة أكبر؟ زِد
gap(القيمة الافتراضية16) أو أضفoffsetTop.
محتوى الشريط الجانبي يتغير ارتفاعه
لا حاجة إلى أي إجراء. يراقب ResizeObserver الشريط الجانبي وأباه. حين يتغير ارتفاع الشريط الجانبي وهو محرَّر، يُعاد ارتكازه عند موضعه الحالي على الشاشة، ويُعاد حساب مواضع التثبيت.
العرض من جهة الخادم
لا تمسّ النواة document وwindow إلا عند استدعاء stickySidebar(). يعمل خطاف React داخل دالة ref، ومدخل React معلَّم بـ "use client". وتعمل دالة composable والموجّه في Vue بعد التركيب (mount). وكلها آمنة للاستيراد في تطبيقات SSR (Next.js وNuxt وVuePress، …).