表单验证

未匹配的标注
本文档最新版为 2.x,旧版本可能放弃维护,推荐阅读最新版!

表单验证

rule

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

$form->text('title')->rules('required|min:3');

// 复杂的验证规则可以在回调里面实现
$form->text('title')->rules(function ($form) {

    // 如果不是编辑状态,则添加字段唯一验证
    if (!$id = $form->model()->id) {
        return 'unique:users,email_address';
    }

});

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

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

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

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

更多规则请参考Validation

creationRules

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

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

updateRules

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

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

返回自定义验证错误信息

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

// 编辑提交时是“PUT”方法
if (request()->getMethod() == 'PUT') {
    if (...) { // 你的验证逻辑
        $form->responseValidationMessages('title', 'title格式错误');

        // 如有多个错误信息,第二个参数可以传数组
        $form->responseValidationMessages('content', ['content格式错误', 'content不能为空']);
    }
}

$form->text('title');
$form->text('content');

前端验证

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

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

H5验证

required

必填

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

number

只允许输入数字

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

限制范围

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

email

邮箱

$form->email('email');

url

链接

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

其它

minLength

限制字符最小长度

$form->text('title')->minLength(20);

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

maxLength

限制字符最大长度

$form->text('title')->maxLength(50);

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

same

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

$form->password('password');

$form->password('password_confirm')->same('password');

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

自定义

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

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

use Dcat\Admin\Form\Field;

Field\Text::macro('len', function (int $length, ?string $error = null) {
    // 前端验证逻辑扩展
    Admin::script(
                <<<'JS'
Dcat.validator.extend('len', function ($el) {
    return $el.val().length != $el.attr('data-len');
});
JS
        );

        // 同时添加后端验证逻辑,这个可以看需要
        $this->rules('size:'.$length);

        return $this->attribute([
            'data-len'       => $length,
            'data-len-error' => str_replace(
                [':attribute', ':len'],
                [$this->label, $length],
                $error ?: "只能输入:len个字符"
            ),
        ]);
});

使用

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

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
讨论数量: 0
发起讨论 只看当前版本


暂无话题~