کتابخانه
select2 یه کتابخانه جاوااسکریپت بر پایه jQuery هست که select معمولی HTML رو به یه لیست انتخاب مدرن تبدیل می کنه. کاربر می تونه بین گزینه ها جستجو کنه، چند مورد رو انتخاب کنه یا داده رو از سرور بگیره. برای فرم هایی که گزینه هاشون زیاده، مثل شهر، دسته بندی و محصول، به درد می خوره.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۷۹۲ کیلوبایت· ۱۸۵ فایل· انتشار
SHA-256: 15692c266649fbc8acb4ebfb345e7e9499486d9551148241a235c9d62eea2f55
select2 رو وقتی سراغش می ری که select ساده HTML دیگه جواب نمی ده. فرض کن فرم ثبت آدرس داری و کاربر باید بین چند صد شهر و روستا یکی رو انتخاب کنه. اسکرول کردن توی لیست پیش فرض مرورگر واقعاً اذیت می کنه. select2 همون المنت رو برمی داره و بهش یه کادر جستجو اضافه می کنه. کاربر چند حرف می نویسه و گزینه ها همون لحظه فیلتر می شن.
کارهای زیادی ازش برمیاد: جستجو بین گزینه ها، انتخاب چندتایی، ساخت تگ، متن راهنما (placeholder) و گرفتن گزینه ها از سرور با AJAX. infinite scrolling هم داره، یعنی نتایج با اسکرول کاربر صفحه به صفحه لود می شن و لازم نیست هزاران گزینه یه جا توی صفحه بشینه. برای سایت فارسی هم فایل زبان و حالت راست به چپ هست. فقط یادت باشه هر دو رو تنظیم کنی و ظاهر لیست رو توی چند مرورگر چک کنی.
پیشخوان و پنل مدیریت، فرم های سفارشی، فیلتر فروشگاه و فرم ثبت نام جاهای خوبی براش هستن. توی وردپرس یه نکته رو جدی بگیر: خیلی از افزونه ها خودشون یه نسخه از select2 یا چیزی شبیه اون رو همراه دارن. اگه تو هم دستی یه نسخه دیگه به قالبت اضافه کنی، ممکنه دو بار لود بشه و ظاهر یا رفتار لیست ها به هم بریزه. قبل از اضافه کردن ببین چیزی از قبل توی سایتت لود می شه یا نه.
جاهایی هم هست که select2 لازم نیست. اگه فقط دو سه گزینه داری، select ساده کافیه. اگه سایتت jQuery نداره و می خوای صفحه سبک بمونه، اضافه کردنش فقط برای یه لیست به صرفه نیست. روی موبایل هم select پیش فرض مرورگر معمولاً تجربه خوبی داره. اگه بیشتر کاربرهات موبایلی هستن، حتماً با گوشی واقعی تستش کن.
مجوز select2 از نوع MIT هست و توی پروژه های تجاری هم می تونی ازش استفاده کنی، فقط متن مجوز رو حذف نکن. نسخه های رسمی و بدون تغییرش توی مخزن داخلی ما هم هست. اگه روزی دسترسی به npm یا CDN های خارجی قطع یا کند شد، فایل ها رو از همین جا بردار و روی هاست خودت بذار.
استفاده از select2 توی یه صفحه چند قدم ساده داره:
توی وردپرس اسکریپت ها رو با روش استاندارد خود وردپرس ثبت کن، نه با چسباندن مستقیم توی قالب. اینجوری وابستگی به jQuery درست مدیریت می شه و کمتر با افزونه ها تداخل پیدا می کنی. بعد از هر تغییر، کش سایت و مرورگر رو پاک کن تا نتیجه رو درست ببینی.
select2 یه کتابخانه جاوااسکریپت بر پایه jQuery هست که select معمولی HTML رو جایگزین می کنه. با اون لیست انتخاب، قابلیت جستجو، انتخاب چندتایی، تگ و گرفتن داده از سرور پیدا می کنه. وقتی گزینه ها زیادن، مثل لیست شهرها یا محصولات، حسابی به کارت میاد. برای دو سه گزینه لازمش نداری.
نه، select2 به jQuery وابسته هست و jQuery باید قبل از اون توی صفحه لود بشه. اگه سایتت از قبل jQuery داره، مشکلی نیست. اگه نداره، باید اضافه اش کنی. توی وردپرس معمولاً خود هسته jQuery رو داره و فقط باید ترتیب لود اسکریپت ها رو درست ثبت کنی.
حالت راست به چپ رو توی تنظیمات فعال کن و فایل زبان فارسی رو هم لود کن تا پیام های داخلی، مثل «نتیجه ای پیدا نشد»، فارسی نشون داده بشن. بعدش ظاهر لیست رو توی چند مرورگر و روی موبایل چک کن. جزئیات دقیق رو توی مستندات همون نسخه ای که برداشتی ببین.
معمولاً دلیلش لود شدن چند نسخه از کتابخانه هست. بعضی افزونه ها و قالب ها خودشون یه نسخه همراه دارن و با نسخه ای که تو اضافه کردی تداخل پیدا می کنه. چک کن فقط یه نسخه لود بشه، ترتیب jQuery درست باشه و کش سایت رو هم پاک کن.
بله، select2 مجوز MIT داره و استفاده تجاری با این مجوز مشکلی نداره. فقط باید اطلاعات مجوز و حق نشر رو توی فایل ها نگه داری. اگه فایل ها رو تغییر دادی هم همین قاعده برقراره. برای اطمینان بیشتر، متن مجوزی که همراه همون نسخه هست رو یه بار بخون.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.