表单验证

rule

model-form使用laravel的验证规则来验证表单提交的数据：

  1. $form->text('title')->rules('required|min:3');
  3. // 复杂的验证规则可以在回调里面实现
  4. $form->text('title')->rules(function ($form) {
  6.     // 如果不是编辑状态，则添加字段唯一验证
  7.     if (!$id = $form->model()->id) {
  8.         return 'unique:users,email_address';
  9.     }
  11. });

也可以给验证规则自定义错误提示消息：

  1. $form->text('code')->rules('required|regex:/^\d+$/|min:10', [
  2.     'regex' => 'code必须全部为数字',
  3.     'min'   => 'code不能少于10个字符',
  4. ]);

如果要允许字段为空，首先要在数据库的表里面对该字段设置为NULL，然后

  1. $form->text('title')->rules('nullable');

更多规则请参考Validation。

creationRules

此方法用法和Form\Field::rule用法完全一致，不同的是此方法只有在新增数据时才有效。

{tip} 如果调用了creationRules方法，则rule方法设置的验证规则将会被忽略。

updateRules

此方法用法和Form\Field::rule用法完全一致，不同的是此方法只有在更新数据时才有效。

{tip} 如果调用了updateRules方法，则rule方法设置的验证规则将会被忽略。

返回自定义验证错误信息

通过Form::responseValidationMessages方法可以返回自定义验证错误信息，如下：

  1. // 编辑提交时是“PUT”方法
  2. if (request()->getMethod() == 'PUT') {
  3.     if (...) { // 你的验证逻辑
  4.         $form->responseValidationMessages('title', 'title格式错误');
  6.         // 如有多个错误信息，第二个参数可以传数组
  7.         $form->responseValidationMessages('content', ['content格式错误', 'content不能为空']);
  8.     }
  9. }
  11. $form->text('title');
  12. $form->text('content');

前端验证

系统继承了bootstrap-validator进行前端表单验证，支持H5表单类型的验证。

{tip} 不支持H5的浏览器也可以使用前端验证，系统已经做好了兼容。大部分表单都支持前端和后端验证，两者可以同时工作不冲突，少部分表单前端验证无效。

H5验证

required

必填

  1. $form->text('title')->required();

number

只允许输入数字

  1. $form->text('age')->type('number');

限制范围

  1. // 只允许输入 10-60 范围内的数字
  2. $form->text('age')
  3.     ->type('number')
  4.     ->attribute('min', 10)
  5.     ->attribute('max', 60);

email

邮箱

  1. $form->email('email');

url

链接

  1. $form->text('website')->type('url');

其它

minLength

限制字符最小长度

  1. $form->text('title')->minLength(20);
  3. // 设置错误信息
  4. $form->text('title')->minLength(20, '最少输入20个字符');

maxLength

限制字符最大长度

  1. $form->text('title')->maxLength(50);
  3. // 设置错误信息
  4. $form->text('title')->minLength(50, '不能超过50个字符');

same

限制当前字段值必须与给定字段的值相等，常用于密码确认

  1. $form->password('password');
  3. $form->password('password_confirm')->same('password');
  5. // 设置错误信息
  6. $form->password('password_confirm')->same('password', '两次密码输入不一致');

自定义

开发者可以通过以下方法自定义前端验证规则。

在 app/Admin/bootstrap.php 中添加以下代码。

  1. use Dcat\Admin\Form\Field;
  3. Field\Text::macro('len', function (int $length, ?string $error = null) {
  4.     // 前端验证逻辑扩展
  5.     Admin::script(
  6.                 <<<'JS'
  7. Dcat.validator.extend('len', function ($el) {
  8.     return $el.val().length != $el.attr('data-len');
  9. });
  10. JS
  11.         );
  13.         // 同时添加后端验证逻辑，这个可以看需要
  14.         $this->rules('size:'.$length);
  16.         return $this->attribute([
  17.             'data-len'       => $length,
  18.             'data-len-error' => str_replace(
  19.                 [':attribute', ':len'],
  20.                 [$this->label, $length],
  21.                 $error ?: "只能输入:len个字符"
  22.             ),
  23.         ]);
  24. });

使用

  1. $form->text('name')->len(10);