本文实例讲述了Yii2创建表单的方法。分享给大家供大家参考,具体如下:

表单的生成
表单中的方法

由于表单涉及到一些验证方面的信息,属性设置又比较多、比较复杂,所以哪里有什么不正确的地方请留言指点

    ActiveForm::begin()方法
    ActiveForm::end()方法
    getClientOptions()方法
    其它方法:errorSummary、validate、validateMultiple

目录

表单中的参数

表单中的方法 ActiveForm::begin方法 getClientOptions()方法
其它方法:errorSummary、validate、validateMultiple

    表单form自身的属性
    表单中各个项(field)输入框相关的属性
        $fieldConfig
        关于验证的属性
        关于每个field容器样式的属性
    ajax验证
    前端js事件
    表单中的其它属性

表单中的参数 表单form自身的属性 表单中各个项输入框相关的属性
$fieldConfig 关于验证的属性 关于每个field容器样式的属性 ajax验证
前端js事件 表单中的其它属性

1、表单的生成
在Yii中表单即ActiveForm也是Widget,在上面可以看到是由begin开始

我们先看看Yii里面最简单的登录表单以及生成的html代码和界面,先有个直观的了解

    <?php $form = ActiveForm::begin([‘id’ => ‘login-form’]);
?>

 'login-form']); ?> field ?> field->passwordInput() ?> field->checkbox() ?>  If you forgot your password you can     'btn btn-primary', 'name' => 'login-button']) ?> 

复制代码
中间为各个项的输入框,最后由end结尾

下面是生成的表单Html,我在里面标明了5部分。

    <?php ActiveForm::end(); ?>

1、表单的生成

复制代码

在Yii中表单即ActiveForm也是Widget,在上面可以看到是由begin开始

2、表单中的方法
在Widget中begin()方法会调用int方法

 'login-form']); ?>

    public function init()

中间为各个项的输入框,最后由end结尾

复制代码
在最后的end()方法会调用run方法

2、表单中的方法

    public function run()

在Widget中begin()方法会调用int方法

复制代码

public function init方法会调用run方法public function run()

1、ActiveForm::begin()方法

1、ActiveForm::begin()方法

    //这个是在执行 $form = ActiveForm::begin([‘id’ =>
‘login-form’]); 中的begin方法的时候调用的
    public function init()
    {
             //设置表单元素form的id
            if (!isset($this->options[‘id’])) {
                $this->options[‘id’] = $this->getId();
            }
            //设置表单中间的要生成各个field的所使用的类
            if (!isset($this->fieldConfig[‘class’])) {
                $this->fieldConfig[‘class’] =
ActiveField::className();
            }
            //这个就是输出表单的开始标签
            //如:<form id=”login-form”
action=”/lulublog/frontend/web/index.php?r=site/login”
method=”post”>
            echo Html::beginForm($this->action, $this->method,
$this->options);
    }

//这个是在执行 $form = ActiveForm::begin(['id' => 'login-form']); 中的begin方法的时候调用的public function init(){ //设置表单元素form的id if (!isset) { $this->options['id'] = $this->getId(); } //设置表单中间的要生成各个field的所使用的类 if (!isset($this->fieldConfig['class'])) { $this->fieldConfig['class'] = ActiveField::className(); } //这个就是输出表单的开始标签 //如:

复制代码

echo Html::beginForm($this->action, $this->method,
$this->options);}

2、ActiveForm::end()方法

2、ActiveForm::end()方法

    //这个是在执行 ActiveForm::end(); 中的end方法的时候调用的
    public function run()
    {
            //下面这个就是往视图中注册表单的js验证脚本,
            if (!empty($this->attributes)) {
                $id = $this->options[‘id’];
                $options = Json::encode($this->getClientOptions());
                $attributes = Json::encode($this->attributes);
                $view = $this->getView();
                ActiveFormAsset::register($view);
                /*
                 *
$attributes:为要验证的所有的field数组。它的值是在activeform中创建field的时候,在field的begin方法中给它赋值的。
                 * 其中每个field又是一个数组,为这个field的各个参数
                 * 比如username的field中的参数有
                 * validate、id、name、
                 *
validateOnChange、validateOnType、validationDelay、
                 * container、input、error
                 *
                 * $options:为这个表单整体的属性,如:
                 * errorSummary、validateOnSubmit、
                 *
errorCssClass、successCssClass、validatingCssClass、
                 * ajaxParam、ajaxDataType
                 */
                
               
$view->registerJs(“jQuery(‘#$id’).yiiActiveForm($attributes,
$options);”);
            }
            //输出表单的结束标签
            echo Html::endForm();
    }

//这个是在执行 ActiveForm::end(); 中的end方法的时候调用的public function run(){ //下面这个就是往视图中注册表单的js验证脚本, if (!empty { $id = $this->options['id']; $options = Json::encode($this->getClientOptions; $attributes = Json::encode; $view = $this->getView(); ActiveFormAsset::register; /* * $attributes:为要验证的所有的field数组。它的值是在activeform中创建field的时候,在field的begin方法中给它赋值的。 * 其中每个field又是一个数组,为这个field的各个参数 * 比如username的field中的参数有 * validate、id、name、 * validateOnChange、validateOnType、validationDelay、 * container、input、error * * $options:为这个表单整体的属性,如: * errorSummary、validateOnSubmit、 * errorCssClass、successCssClass、validatingCssClass、 * ajaxParam、ajaxDataType */ $view->registerJs.yiiActiveForm($attributes, $options);"); } //输出表单的结束标签 echo Html::endForm();}

复制代码

3、getClientOptions()方法

3、getClientOptions()方法

/** 设置表单的全局的一些样式属性以及js回调事件等*/protected function getClientOptions(){ $options = [ 'errorSummary' => '.' . $this->errorSummaryCssClass, 'validateOnSubmit' => $this->validateOnSubmit, 'errorCssClass' => $this->errorCssClass, 'successCssClass' => $this->successCssClass, 'validatingCssClass' => $this->validatingCssClass, 'ajaxParam' => $this->ajaxParam, 'ajaxDataType' => $this->ajaxDataType, ]; if ($this->validationUrl !== null) { $options['validationUrl'] = Url::to; } foreach (['beforeSubmit', 'beforeValidate', 'afterValidate'] as $name) { if (($value = $this->$name) !== null) { $options[$name] = $value instanceof JsExpression ? $value : new JsExpression; } } return $options;}

    /*
    * 设置表单的全局的一些样式属性以及js回调事件等
    */
    protected function getClientOptions()
    {
            $options = [
                ‘errorSummary’ => ‘.’ .
$this->errorSummaryCssClass,
                ‘validateOnSubmit’ => $this->validateOnSubmit,
                ‘errorCssClass’ => $this->errorCssClass,
                ‘successCssClass’ => $this->successCssClass,
                ‘validatingCssClass’ =>
$this->validatingCssClass,
                ‘ajaxParam’ => $this->ajaxParam,
                ‘ajaxDataType’ => $this->ajaxDataType,
            ];
            if ($this->validationUrl !== null) {
                $options[‘validationUrl’] =
Url::to($this->validationUrl);
            }
            foreach ([‘beforeSubmit’, ‘beforeValidate’,
‘afterValidate’] as $name) {
                if (($value = $this->$name) !== null) {
                    $options[$name] = $value instanceof JsExpression ?
$value : new JsExpression($value);
                }
            }

下面这个是生成的表单验证Js代码

            return $options;
    }

jQuery.ready { jQuery.yiiActiveForm( { "username":{ "validate":function (attribute, value, messages) { yii.validation.required(value, messages, {"message":"Username cannot be blank."}); }, "id":"loginform-username", "name":"username", "validateOnChange":true, "validateOnType":false, "validationDelay":200, "container":".field-loginform-username", "input":"#loginform-username", "error":".help-block"}, "password":{ "validate":function (attribute, value, messages) { yii.validation.required(value, messages, {"message":"Password cannot be blank."}); }, "id":"loginform-password", "name":"password", "validateOnChange":true, "validateOnType":false, "validationDelay":200, "container":".field-loginform-password", "input":"#loginform-password", "error":".help-block" }, "rememberMe":{ "validate":function (attribute, value, messages) { yii.validation.boolean(value, messages, { "trueValue":"1","falseValue":"0","message":"Remember Me must be either "1" or "0".","skipOnEmpty":1}); }, "id":"loginform-rememberme", "name":"rememberMe","validateOnChange":true, "validateOnType":false, "validationDelay":200, "container":".field-loginform-rememberme", "input":"#loginform-rememberme", "error":".help-block"} }, { "errorSummary":".error-summary", "validateOnSubmit":true, "errorCssClass":"has-error", "successCssClass":"has-success", "validatingCssClass":"validating", "ajaxParam":"ajax", "ajaxDataType":"json" });});

复制代码

4、其它方法:errorSummary、validate、validateMultiple

下面这个是生成的表单验证Js代码

public function errorSummary($models, $options = [])

    jQuery(document).ready(function () {
            jQuery(‘#login-form’).yiiActiveForm(
            {
                    “username”:{
                            “validate”:function (attribute, value,
messages) {
                                    yii.validation.required(value,
messages, {“message”:”Username cannot be blank.”});
                            },
                            “id”:”loginform-username”,
                            “name”:”username”,
                            “validateOnChange”:true,
                            “validateOnType”:false,
                            “validationDelay”:200,
                            “container”:”.field-loginform-username”,
                            “input”:”#loginform-username”,
                            “error”:”.help-block”},
                    “password”:{
                            “validate”:function (attribute, value,
messages) {
                                    yii.validation.required(value,
messages, {“message”:”Password cannot be blank.”});
                            },
                            “id”:”loginform-password”,
                            “name”:”password”,
                            “validateOnChange”:true,
                            “validateOnType”:false,
                            “validationDelay”:200,
                            “container”:”.field-loginform-password”,
                            “input”:”#loginform-password”,
                            “error”:”.help-block”
                            },

它主要就是把model中的所有的错误信息汇总到一个div中。

                    “rememberMe”:{
                            “validate”:function (attribute, value,
messages) {
                                    yii.validation.boolean(value,
messages, {
                                           
“trueValue”:”1″,”falseValue”:”0″,”message”:”Remember Me must be either
“1” or “0”.”,”skipOnEmpty”:1});
                            },
                            “id”:”loginform-rememberme”,
                           
“name”:”rememberMe”,”validateOnChange”:true,
                            “validateOnType”:false,
                            “validationDelay”:200,
                            “container”:”.field-loginform-rememberme”,
                            “input”:”#loginform-rememberme”,
                            “error”:”.help-block”}
            },
            {
                    “errorSummary”:”.error-summary”,
                    “validateOnSubmit”:true,
                    “errorCssClass”:”has-error”,
                    “successCssClass”:”has-success”,
                    “validatingCssClass”:”validating”,
                    “ajaxParam”:”ajax”,
                    “ajaxDataType”:”json”
            });
    });

public static function validate($model, $attributes = null)public static function validateMultiple($models, $attributes = null)

复制代码

这两个是获取错误信息的方法,比较简单也不说了。

4、其它方法:errorSummary、validate、validateMultiple

3、表单中的参数

    public function errorSummary($models, $options = [])

相关文章