پرش به مطلب اصلی

تنظیمات Form Validation

فایل config/dornica-form-validation.php رفتار validation سمت مرورگر را کنترل می‌کند. اگر پروژه از JavaScript validation تولیدشده توسط Doravel استفاده می‌کند، این فایل تعیین می‌کند validation روی چه فرم‌هایی اعمال شود و هنگام خطا چه رفتاری دیده شود.

نکته

اگر دنبال نحوه استفاده در فرم‌ها، FormRequest و کامپوننت‌ها هستید، صفحه FormValidation را ببینید.
این صفحه فقط درباره تنظیمات سراسری package است.

form_selector​

'form_selector' => 'form',

selector پیش‌فرض برای پیدا کردن فرم‌هایی است که باید validation روی آن‌ها اعمال شود. default package همه فرم‌ها را هدف می‌گیرد.

focus_on_error​

'focus_on_error' => true,

اگر true باشد، پس از خطای validation مرورگر focus را به اولین فیلد نامعتبر منتقل می‌کند و فرم را به ناحیه اولین خطا scroll می‌کند. default package برای این گزینه true است.

disable_remote_validation​

'disable_remote_validation' => false,

اگر false باشد، ruleهایی مثل unique، exists و ruleهای وابسته به دیتابیس می‌توانند از validation سمت سرور استفاده کنند. اگر پروژه به هر دلیل باید این رفتار را خاموش کند، همین کلید نقطه کنترل آن است.

ignore​

'ignore' => [
    ':hidden',
    "[contenteditable='true']",
],

selector پیش‌فرض elementهایی است که validation روی آن‌ها نادیده گرفته می‌شود. این مقدار مستقیما به گزینه ignore در jQuery Validate پاس داده می‌شود.

نکات عملی​

  • اگر فرم‌های dynamic دارید، ignore و form_selector را با هم بررسی کنید.
  • اگر remote validation کند شده یا در محیط خاصی مشکل شبکه دارد، موقتاً می‌توان disable_remote_validation را تغییر داد.
  • اگر روی بعضی componentهای hidden یا custom validation اجرا نمی‌شود، ابتدا ignore را بررسی کنید.