کتابخانه
choices.js یه کتابخونه جاوااسکریپت سبک و بدون وابستگیه که select و input متنی ساده HTML رو به فیلدهای قابل جستجو، چند انتخابی و برچسبی تبدیل می کنه. اگه فرم هات لیست بلند یا فیلد کلمه کلیدی دارن و ظاهر پیش فرض مرورگر جواب نمی ده، انتخاب جمع و جوریه. مجوزش MIT و آزاده.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۱٫۶ مگابایت· ۲۲ فایل· انتشار
SHA-256: cb6805adda4eaf3251fe5adbde5f2f62c80ea1c29b7999b158546a77d1e191d6
choices.js رو Josh Johnson ساخته. توضیح رسمیش اینه که یه پلاگین سفارشی پذیر برای input متنی و select box با جاوااسکریپت خالصه. یعنی برای کار کردنش به jQuery یا فریم ورک خاصی نیاز نداری. فقط فایل جاوااسکریپت و CSS رو به صفحه اضافه می کنی و فیلد معمولیت رو بهش می دی.
مشکلی که حل می کنه آشناست. select پیش فرض مرورگر وقتی گزینه ها زیاد می شن اذیت می کنه: جستجو نداره، تغییر ظاهرش سخته و انتخاب چندتایی توش راحت نیست. فرض کن تو فرم ثبت سفارش باید از بین ده ها شهر یکی رو انتخاب کنی. با choices.js همون select یه کادر جستجو پیدا می کنه. تو حالت چند انتخابی، گزینه های انتخاب شده مثل تگ کنار هم نشون داده می شن و می تونی برای هر کدوم دکمه حذف بذاری. input متنی هم می تونه به فیلد برچسب تبدیل بشه، مثلا برای وارد کردن کلمه های کلیدی یا ایمیل ها.
این کتابخونه برای توسعه دهنده هایی مناسبه که روی قالب یا افزونه اختصاصی وردپرس کار می کنن یا پنل مدیریت و فرم سفارشی می سازن. چون وابستگی نداره و سبکه، برای سایت هایی که سرعت براشون مهمه انتخاب خوبیه. ظاهرش هم با CSS عوض می شه و می تونی با رنگ و فونت قالب خودت هماهنگش کنی.
یه چیز رو قبل از استفاده چک کن. سایت فارسی راست چینه، پس حتما با dir=rtl و داده های فارسی خودت تستش کن. سمت باز شدن لیست، جای دکمه حذف و جستجوی حروفی مثل «ی» و «ک» با املاهای مختلف ممکنه به تنظیم CSS یا آماده سازی داده نیاز داشته باشه. از اون طرف، اگه فقط یه select با چهار پنج گزینه داری، choices.js زیادی سنگینه و select معمولی کفایت می کنه.
نسخه های رسمی و بدون تغییر choices.js تو مخزن داخلی ما هم هست. وقتی دسترسی به npm یا منابع خارجی قطع یا کند می شه، می تونی فایل ها رو از همین جا برداری و روی هاست خودت بذاری.
راه انداختن choices.js چند قدم بیشتر نیست:
اگه فیلد تو فرم داینامیک یا ایجکسی ساخته می شه، کتابخونه رو بعد از اضافه شدن المنت به صفحه فعال کن، نه قبلش.
choices.js یه کتابخونه جاوااسکریپت برای ارتقای select و input متنیه. select معمولی مرورگر جستجو نداره و استایل دادنش سخته. این کتابخونه همون فیلد رو به لیست قابل جستجو، انتخاب چندتایی با تگ یا فیلد برچسب تبدیل می کنه و ظاهرش با CSS قابل تغییره.
نه. choices.js با جاوااسکریپت خالص نوشته شده و به jQuery وابسته نیست. اگه سایتت jQuery داره، مشکلی پیش نمیاد و می تونی کنارش استفاده کنی. اگه نداره هم لازم نیست چیز اضافه ای لود کنی؛ فایل جاوااسکریپت و CSS خود کتابخونه کافیه.
با متن فارسی مشکلی نداره، ولی جزئیات راست چین مثل جای فلش، دکمه حذف و سمت باز شدن لیست ممکنه به CSS اضافه نیاز داشته باشه. جستجوی حروفی مثل «ی» و «ک» با املای عربی رو هم با داده های واقعی خودت تست کن. قبل از انتشار روی سایت اصلی، یه بار تو محیط آزمایشی امتحانش کن.
آره. چون کتابخونه مستقله، می تونی فایل هاش رو تو قالب یا افزونه اختصاصی خودت با wp_enqueue_script و wp_enqueue_style اضافه کنی و روی فیلدهای فرم فعالش کنی. فقط حواست باشه افزونه یا قالب دیگه ای همون فیلد رو با کتابخونه مشابه تغییر نده، چون تداخل پیش میاد.
MIT یکی از آزادترین مجوزهای متن بازه. می تونی choices.js رو تو سایت شخصی یا تجاری استفاده کنی و تغییرش بدی. فقط باید متن مجوز و اطلاعیه کپی رایت اصلی رو همراه کد نگه داری. برای جزئیات دقیق، فایل LICENSE داخل بسته رو بخون.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.