کتابخانه
jquery-validation یه پلاگین جی کوئری برای اعتبارسنجی فرم ها سمت مرورگر هست. با چند قانون ساده مثل اجباری بودن فیلد، فرمت ایمیل یا حداقل طول، قبل از ارسال فرم خطا رو همون لحظه به کاربر نشون می ده و پر کردن فرم رو راحت تر می کنه.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۳۷۵ کیلوبایت· ۱۳۲ فایل· انتشار
SHA-256: d48b8fee4fe0f9df7cfebe7e0f52365f6c3ec61055249fac853ec3d645d7898b
jquery-validation کتابخانه ای از Jörn Zaefferer با مجوز MIT هست که اعتبارسنجی فرم رو روی جی کوئری سوار می کنه. مشکلش رو احتمالاً می شناسی: کاربر فرم ثبت نام یا سفارش رو پر می کنه، دکمه ارسال رو می زنه، صفحه می ره سمت سرور و با یه خطا برمی گرده. با اینترنت کند و ناپایدار این رفت و برگشت خیلی اذیت می کنه. این کتابخانه خطا رو همون لحظه و کنار خود فیلد نشون می ده، پس کاربر منتظر سرور نمی مونه و سریع می فهمه چی رو اشتباه زده.
قانون ها رو به دو شکل می تونی تعریف کنی: مستقیم با ویژگی های HTML مثل required و minlength، یا با صدا زدن validate() روی فرم و دادن شیء rules و messages. قانون آماده برای ایمیل، عدد، آدرس وب و تاریخ داره. equalTo برای تکرار رمز عبور به دردت می خوره و remote می تونه مثلاً آزاد بودن یه نام کاربری رو از سرور بپرسه. فایل additional-methods قانون های بیشتری اضافه می کنه. با addMethod هم می تونی قانون خودت رو بنویسی، مثلاً برای شماره موبایل یا کد ملی که تو فرم های ایرانی خیلی لازم می شه.
پیام های خطا قابل تغییرن، پس می تونی همه رو فارسی و با لحن خود سایتت بنویسی. ترجمه چند زبان هم همراه کتابخانه هست، ولی برای متن فارسی بهتره messages رو خودت تنظیم کنی تا دقیقاً به لحن سایتت بخوره. ظاهر پیام ها رو هم با CSS معمولی می تونی دربیاری.
اگه سایتت از قبل جی کوئری داره، مثل خیلی از سایت های وردپرسی با قالب و افزونه های قدیمی تر، انتخاب خوبیه. ولی اگه پروژه ات با React یا Vue نوشته شده یا اصلاً jQuery نداری، آوردنش فقط برای اعتبارسنجی منطقی نیست. تو این حالت سراغ اعتبارسنجی خود فریم ورک یا ویژگی های استاندارد HTML برو. اگه قانون پیچیده ای مثل کد ملی نوشتی، حتماً با چند ورودی درست و غلط تستش کن. یه نکته هم یادت باشه: اعتبارسنجی سمت مرورگر فقط برای راحتی کاربره، چون جاوااسکریپت رو می شه دور زد. همه ورودی ها رو سمت سرور هم باید چک کنی.
نسخه های رسمی و بدون تغییر jquery-validation تو مخزن داخلی ما هم هست. وقتی دسترسی به منابع خارجی مشکل داره، می تونی فایل رو از همین جا بگیری و روی هاست خودت بذاری.
استفاده ازش چهار قدم بیشتر نیست:
برای تست، فرم رو خالی بفرست و ببین پیام ها کنار فیلدها میان یا نه. اگه هیچ اتفاقی نیفتاد، اول کنسول مرورگر رو نگاه کن. معمولاً یا ترتیب لود فایل ها اشتباهه یا فیلدها name ندارن. اگه فرم رو با Ajax می فرستی، تابع submitHandler رو تو همون تنظیمات validate() بذار تا ارسال فقط وقتی فرم معتبره انجام بشه. برای راست چین کردن پیام ها هم کافیه کلاس خطا رو با CSS استایل بدی.
نه. این کتابخانه پلاگین جی کوئریه و بدون اون اجرا نمی شه. باید اول jQuery و بعدش فایل jquery-validation لود بشه، وگرنه تو کنسول خطا می گیری. اگه سایتت jQuery نداره و نمی خوای اضافه اش کنی، بهتره از اعتبارسنجی استاندارد HTML یا یه کتابخانه مستقل استفاده کنی.
تو تنظیمات validate() بخش messages رو پر کن و برای هر فیلد و هر قانون متن فارسی بنویس. اگه می خوای پیام ها یه جا برای همه فرم ها عوض بشن، پیام های پیش فرض رو یک بار با $.validator.messages بازنویسی کن. اینجوری لازم نیست برای هر فرم جدا تکرارشون کنی.
نه، قانون آماده مخصوص ایران نداره و نمی شه روش حساب کرد. ولی با addMethod می تونی قانون سفارشی بنویسی و الگوی شماره موبایل یا الگوریتم کد ملی رو توش بذاری. بعدش مثل بقیه قانون ها تو rules استفاده اش می کنی. یادت باشه قبل از انتشار با چند نمونه درست و غلط تستش کنی.
بله، هست. اعتبارسنجی سمت مرورگر فقط تجربه کاربر رو بهتر می کنه. کسی که جاوااسکریپت رو غیرفعال کنه یا درخواست رو مستقیم به سرور بفرسته، از این بررسی رد می شه. برای همین همیشه ورودی ها رو سمت سرور هم چک کن.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.