پرش به محتوا

کتابخانه

دانلود @splidejs/splide و نشانی CDN ایرانی

Splide (با نام بسته @splidejs/splide) یه کتابخانه جاوااسکریپت سبک برای ساخت اسلایدر و کروسله. به کتابخانه دیگه ای وابسته نیست، با کیبورد و صفحه خوان سازگاره و برای بنر صفحه اصلی، لیست محصولات، گالری تصاویر و نظرات مشتری ها به کار می ره. مجوزش MIT هست و تو وردپرس و پروژه های HTML ساده راحت اجرا می شه.

نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.

آخرین نسخه
۴.۱.۴
نسخه‌ها در مخزن
۹
مجوز
MIT
سازنده
Naotoshi Fujita
آخرین بررسی
آخرین به‌روزرسانی
توضیحات

آخرین نسخه

آخرین نسخه ۴.۱.۴ آخرین

۳۵۷ کیلوبایت· ۱۴ فایل· انتشار

دانلود
نشانی مستقیم فایل اصلی https://mirror.wbweb.ir/npm/@splidejs/splide@4.1.4/dist/js/splide.min.js
کد آماده با SRI <script src="https://mirror.wbweb.ir/npm/@splidejs/splide@4.1.4/dist/js/splide.min.js" integrity="sha256-FZsW7H2V5X9TGinSjjwYJ419Xka27I8XPDmWryGlWtw=" crossorigin="anonymous"></script>

SHA-256: 159b16ec7d95e57f531a29d28e3c18278d7d5e46b6ec8f173c3996af21a55adc

درباره @splidejs/splide (اسپلاید)

اگه تا حالا برای یه اسلایدر ساده مجبور شدی یه کتابخانه سنگین و وابسته به jQuery رو بکشی تو صفحه، Splide دقیقاً برای همین دردسر ساخته شده. @splidejs/splide رو Naotoshi Fujita نوشته و مجوزش MIT هست، یعنی هم تو پروژه شخصی و هم تو کار مشتری می تونی ازش استفاده کنی. معرفی خود پروژه هم همینه: اسلایدر سبک، انعطاف پذیر و در دسترس، بدون وابستگی به کتابخانه دیگه.

کار اصلی Splide نمایش یه مجموعه اسلاید تو یه کادره. مثلاً بنر بالای صفحه اصلی، ردیف محصولات پرفروش فروشگاه، گالری نمونه کار یا بخش نظرات مشتری ها. حالت اسلاید معمولی، چرخشی (loop) و محو شدن (fade) رو داره. می تونی تعداد اسلاید هر صفحه رو مشخص کنی و با breakpoints برای موبایل و دسکتاپ تنظیم جدا بدی. پخش خودکار، جهت عمودی و بارگذاری تنبل تصاویر هم جزو امکاناتشه. حالت راست به چپ هم داره، پس برای سایت فارسی لازم نیست سراغ ترفندهای CSS بری.

یه نکته که تو سایت های ایرانی کمتر بهش توجه می شه، دسترسی پذیریه. Splide از کنترل با کیبورد و ویژگی های ARIA پشتیبانی می کنه، پس کاربرهایی که با ماوس یا لمس کار نمی کنن هم می تونن اسلایدت رو بخونن و جابه جا کنن. برای کارهای خاص تر افزونه های جانبی رسمی هم داره، مثلاً برای اسکرول خودکار پیوسته یا چیدمان شبکه ای. برای React و Vue و Svelte هم بسته های جدا وجود داره.

پس کجا به درد می خوره؟ اگه یه کتابخانه سبک و تمیز می خوای که کنترلش دست خودت باشه، انتخاب خوبیه. ولی اگه فقط یه ردیف کارت افقی ساده می خوای که با انگشت کشیده بشه، شاید CSS scroll-snap به تنهایی کافی باشه و اصلاً به کتابخانه احتیاج نداشته باشی. اگه دنبال یه افزونه وردپرس با رابط گرافیکی هستی هم Splide اون نیست. یه کتابخانه ست و باید با HTML و جاوااسکریپت ازش استفاده کنی.

موقع استفاده چند چیز رو یادت باشه. تصاویر اسلایدر رو قبل از آپلود بهینه کن، چون سبک بودن کتابخانه جلوی کند شدن صفحه با عکس های درشت رو نمی گیره. تعداد اسلایدها رو هم زیاد نکن. تو روزهای محدودیت اینترنت بین الملل ممکنه CDN خارجی بالا نیاد، پس بهتره فایل ها رو روی هاست خودت نگه داری. نسخه های رسمی و بدون تغییر این کتابخانه تو مخزن داخلی ما هم در دسترسه و می تونی از همین جا برداری.

راهنمای استفاده

برای اضافه کردن Splide به یه صفحه، همین قدم های کلی کافیه:

  • فایل های جاوااسکریپت و CSS کتابخانه رو از همین صفحه بگیر و روی هاست خودت بذار. اگه ترجیح می دی، کد آماده پایین همین صفحه رو مستقیم تو قالب یا صفحه ات استفاده کن.
  • فایل CSS رو تو بخش head لود کن و فایل جاوااسکریپت رو درست قبل از بسته شدن body.
  • ساختار HTML رو بساز: یه div با کلاس splide، داخلش یه div با کلاس splide__track، بعدش یه ul با کلاس splide__list، و هر اسلاید یه li با کلاس splide__slide.
  • یه اسکریپت کوچیک بنویس که Splide رو روی همون المان بسازه و mount کنه.
  • گزینه هایی مثل type، perPage، gap، autoplay و breakpoints رو بر اساس نیازت تنظیم کن. اگه سایتت فارسیه، جهت rtl رو هم فعال کن.

تو وردپرس هم مسیر همینه. فایل ها رو با wp_enqueue_style و wp_enqueue_script از functions.php قالب یا یه افزونه کوچیک خودت لود کن. بعدش ساختار HTML رو تو ویجت HTML صفحه ساز یا تو خود قالب بذار. آخرش هم حتماً روی موبایل و با متن فارسی تستش کن، چون مشکل جهت حرکت و فاصله ها همون جا زودتر خودش رو نشون می ده.

همه نسخه‌ها (۹)

نسخه‌های ۴.x ۶ نسخه
  • ۴.۱.۴ آخرین نسخه ۳۵۷ کیلوبایت·
    دانلودنسخه 4.1.4
    نشانی مستقیم فایل اصلی 4.1.4 https://mirror.wbweb.ir/npm/@splidejs/splide@4.1.4/dist/js/splide.min.js
  • ۴.۱.۳ ۳۵۷ کیلوبایت·
    دانلودنسخه 4.1.3
    نشانی مستقیم فایل اصلی 4.1.3 https://mirror.wbweb.ir/npm/@splidejs/splide@4.1.3/dist/js/splide.min.js
  • ۴.۱.۲ ۳۵۷ کیلوبایت·
    دانلودنسخه 4.1.2
    نشانی مستقیم فایل اصلی 4.1.2 https://mirror.wbweb.ir/npm/@splidejs/splide@4.1.2/dist/js/splide.min.js
  • ۴.۰.۷ ۳۵۴ کیلوبایت·
    دانلودنسخه 4.0.7
    نشانی مستقیم فایل اصلی 4.0.7 https://mirror.wbweb.ir/npm/@splidejs/splide@4.0.7/dist/js/splide.min.js
  • ۴.۰.۲ ۳۵۳ کیلوبایت·
    دانلودنسخه 4.0.2
    نشانی مستقیم فایل اصلی 4.0.2 https://mirror.wbweb.ir/npm/@splidejs/splide@4.0.2/dist/js/splide.min.js
  • ۴.۰.۱ ۳۵۳ کیلوبایت·
    دانلودنسخه 4.0.1
    نشانی مستقیم فایل اصلی 4.0.1 https://mirror.wbweb.ir/npm/@splidejs/splide@4.0.1/dist/js/splide.min.js
نسخه‌های ۳.x ۲ نسخه
  • ۳.۶.۱۲ ۳۰۵ کیلوبایت·
    دانلودنسخه 3.6.12
    نشانی مستقیم فایل اصلی 3.6.12 https://mirror.wbweb.ir/npm/@splidejs/splide@3.6.12/dist/js/splide.min.js
  • ۳.۲.۲ ۲۹۸ کیلوبایت·
    دانلودنسخه 3.2.2
    نشانی مستقیم فایل اصلی 3.2.2 https://mirror.wbweb.ir/npm/@splidejs/splide@3.2.2/dist/js/splide.min.js
نسخه‌های ۲.x ۱ نسخه
  • ۲.۴.۲۱ قدیمی‌ترین نسخه ۴۶۲ کیلوبایت·
    دانلودنسخه 2.4.21
    نشانی مستقیم فایل اصلی 2.4.21 https://mirror.wbweb.ir/npm/@splidejs/splide@2.4.21/dist/js/splide.min.js

پرسش‌های رایج

  • نه. Splide وابستگی خارجی نداره و با جاوااسکریپت ساده کار می کنه. فقط فایل جاوااسکریپت و CSS خودش رو لود کن و ساختار HTML رو بساز. اگه سایتت jQuery هم داره، معمولاً تداخلی پیش نمیاد و می تونی کنارش استفاده کنی، چون هیچ کدوم به اون یکی نیازی ندارن.

  • بله، حالت راست به چپ رو پشتیبانی می کنه و تو تنظیمات می تونی جهت رو مشخص کنی. با این حال بعد از پیاده سازی، جهت حرکت اسلایدها، فلش ها و کلیدهای کیبورد رو روی موبایل و دسکتاپ خودت تست کن، چون چیدمان هر قالب یه کم فرق داره.

  • Splide افزونه وردپرس نیست و باید دستی اضافه ش کنی. فایل های CSS و جاوااسکریپت رو با wp_enqueue_style و wp_enqueue_script تو قالب یا یه افزونه کوچیک لود کن، بعد ساختار HTML اسلایدر رو تو صفحه یا ویجت HTML بذار و اسکریپت mount رو اضافه کن.

  • هر دو کتابخانه خوبی برای اسلایدر هستن. Splide تمرکزش روی سبک بودن، سادگی و دسترسی پذیریه، پس اگه فقط یه اسلایدر معمولی و تمیز می خوای انتخاب راحتیه. اگه امکانات خیلی خاص مثل افکت های سه بعدی لازم داری، مستندات هر دو رو نگاه کن و ببین کدوم نیازت رو مستقیم پوشش می ده.

  • بله. مجوز Splide از نوع MIT هست و استفاده تجاری، تغییر و توزیع رو آزاد می ذاره. فقط اطلاعیه مجوز و کپی رایتی که همراه کتابخانه هست نباید حذف بشه. اگه فایل ها رو فشرده می کنی، همون اطلاعیه رو بالای فایل یا تو یه فایل جدا نگه دار.

چیزی که لازم دارید اینجا نیست؟

نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.