عیبیابی
نکته
هشدارهای کنسول زیر فقط در بیلدهای توسعه نمایش داده میشوند. بیلدهای production و بیلد CDN برای صرفهجویی در حجم، آنها را حذف میکنند.
سایدبار اصلاً نمیچسبد
- کش آمده است. در grid/flex، سایدبار بهطور پیشفرض تا ارتفاع کامل ردیف کش میآید.
align-items: startرا به والد یاalign-self: startرا به سایدبار اضافه کنید. چیدمان را ببینید. - یکی از والدها
overflowدارد.overflow: hidden | auto | scrollروی هر والدی، آن را به ظرف sticky تبدیل میکند. ازoverflow: clipاستفاده کنید، یا اگر آن المنت واقعاً ظرف اسکرول است، آن را بهعنوانscrollerپاس بدهید. mediamatch نمیشود. تا وقتی media query برقرار نباشد، نمونه غیرفعال است.- در ابتدا پنهان است. اگر سایدبار در شروع ارتفاع نداشته باشد (
display: none، داخل یک تب بسته)، نمونه منتظر میماند. وقتی نمایان شود،ResizeObserverآن را تشخیص میدهد؛ یاupdate()را صدا بزنید.
خطای "element not found"
اگر selector هیچ المنتی را match نکند، stickySidebar('#sidebar') خطا میدهد. نمونه را بعد از اینکه المنت در DOM قرار گرفت بسازید: بعد از DOMContentLoaded، داخل onMounted / useEffect، یا از adapterهای فریمورک استفاده کنید که این کار را خودشان انجام میدهند.
selector هدر چیزی را match نکرد
[dynamic-sticky-sidebar] header selector ".site-header" matched no elements
selector header هنگام شروع نمونه چیزی پیدا نکرد، پس سایدبار به بالای viewport میچسبد و ممکن است زیر هدر برود. selector را بررسی کنید، یا وقتی هدر رندر شد refresh() را صدا بزنید.
اسکرولر پیدا نشد
[dynamic-sticky-sidebar] scroller "#app" not found, using the window
آپشن scroller به هیچ المنتی resolve نشد. selector را بررسی کنید، یا خود المنت را پاس بدهید.
هشدار کنسول دربارهی grid / row-flex
[dynamic-sticky-sidebar] parent is not grid / row-flex, so scrolling up uses a JS fallback …
والد مستقیم سایدبار یک block است. همهچیز کار میکند، اما اسکرول به بالا ممکن است یک فریم عقب بماند. به والد display: grid; align-items: start بدهید. چیدمان block را ببینید.
سایدبار زیر هدر میرود یا با آن فاصله دارد
- مطمئن شوید همهی ردیفهای هدر در
headerپاس داده شدهاند. با selector، همهی المنتهای matchشده استفاده میشوند. - اگر هدر بهخاطر کلاسی روی یکی از والدها جابهجا میشود، کتابخانه آن را نمیبیند.
update()را صدا بزنید یا ازsubscribeاستفاده کنید. - هدرهایی که بعد از شروع در DOM جایگزین میشوند، به
refresh()نیاز دارند. - فاصلهی بیشتری میخواهید؟
gap(پیشفرض16) را زیاد کنید یاoffsetTopاضافه کنید.
ارتفاع محتوای سایدبار تغییر میکند
کاری لازم نیست. یک ResizeObserver سایدبار و والدش را زیر نظر دارد. اگر ارتفاع سایدبار در حالت آزاد تغییر کند، در همان موقعیت فعلیاش روی صفحه دوباره لنگر میشود و موقعیتهای چسبیده دوباره محاسبه میشوند.
رندر سمت سرور
هسته فقط وقتی stickySidebar() صدا زده شود به document و window دست میزند. هوک React داخل یک ref callback اجرا میشود و نقطهی ورود React با "use client" علامتگذاری شده است. composable و دایرکتیو Vue بعد از mount اجرا میشوند. import کردن همهی آنها در اپهای SSR (Next.js، Nuxt، VuePress و …) امن است.