پارامترهای clearQueue و jumpToEnd در jQuery
در کتابخانه jQuery، متد stop() برای توقف انیمیشن‌های جاری روی یک عنصر استفاده می‌شود. این متد دو پارامتر اختیاری مهم دارد: clearQueue و jumpToEnd که کنترل دقیق‌تری روی رفتار توقف ارائه می‌دهند.
کاربرد پارامتر clearQueue
پارامتر clearQueue یک مقدار بولین (true/false) می‌پذیرد و تعیین می‌کند آیا تمام انیمیشن‌های باقی‌مانده در صف نیز باید متوقف شوند یا خیر:
- مقدار true: تمام انیمیشن‌های بعدی در صف حذف می‌شوند
- مقدار false (پیش‌فرض): فقط انیمیشن جاری متوقف می‌شود
مثال: $("#element").stop(true, false); - این کد انیمیشن جاری را متوقف کرده اما صف انیمیشن‌ها را حفظ می‌کند.
پارامتر jumpToEnd
پارامتر jumpToEnd نیز یک مقدار بولین است که مشخص می‌کند آیا انیمیشن باید بلافاصله به حالت نهایی خود پرش کند یا نه:
| مقدار |
تاثیر |
| true |
انیمیشن به حالت نهایی می‌پرد |
| false |
انیمیشن در حالت فعلی متوقف می‌شود |
برای درک بهتر این مفاهیم، می‌توانید از آموزش‌های موجود در مکث شاپ استفاده کنید.
ترکیب پارامترها
ترکیب این دو پارامتر چهار حالت مختلف ایجاد می‌کند:
- stop(false, false): فقط انیمیشن فعلی متوقف می‌شود
- stop(true, false): انیمیشن فعلی متوقف و صف پاک می‌شود
- stop(false, true): انیمیشن فعلی به پایان می‌پرد
- stop(true, true): انیمیشن فعلی به پایان پرد و صف پاک می‌شود
نکته مهم: استفاده نادرست از این پارامترها ممکن است باعث رفتارهای غیرمنتظره در انیمیشن‌های شما شود. همیشه قبل از استفاده، حالت‌های مختلف را تست کنید.
در پروژه‌های پیچیده که چندین انیمیشن به صورت زنجیره‌ای اجرا می‌شوند، مدیریت صحیح این پارامترها ضروری است. با تنظیم مناسب آن‌ها می‌توانید کنترل کاملی بر جریان انیمیشن‌ها داشته باشید.
