本文实例讲述了Yii2创建表单(ActiveForm)的方法。分享给大家供大家参考，具体如下：
由于表单涉及到一些验证方面的信息，属性设置又比较多、比较复杂，所以哪里有什么不正确的地方请留言指点
目录
表单的生成
表单中的方法 ActiveForm::begin()方法 ActiveForm::end()方法 getClientOptions()方法 其它方法：errorSummary、validate、validateMultiple
表单中的参数 表单form自身的属性 表单中各个项(field)输入框相关的属性 $fieldConfig 关于验证的属性 关于每个field容器样式的属性 ajax验证 前端js事件 表单中的其它属性
我们先看看Yii里面最简单的登录表单以及生成的HTML代码和界面，先有个直观的了解
PHP;">
'login-form']); ?>
field($model,'username') ?>
field($model,'password')->passwordInput() ?>
field($model,'rememberMe')->checkBox() ?>
'btn btn-primary','name' => 'login-button']) ?>
下面是生成的表单Html，我在里面标明了5部分。
1、表单的生成
在Yii中表单即ActiveForm也是Widget，在上面可以看到是由begin开始
PHP;">
'login-form']); ?>
中间为各个项的输入框，最后由end结尾
PHP;">
2、表单中的方法
PHP;">
public function init()
PHP;">
public function run()
方法
'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();
}
//这个就是输出表单的开始标签
//如：
方法
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();
}
方法
'.' . $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);
}
}
return $options;
}
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,{"message":"Password cannot be blank."});
},"id":"loginform-password","name":"password","container":".field-loginform-password","input":"#loginform-password","error":".help-block"
},"rememberMe":{
"validate":function (attribute,messages) {
yii.validation.boolean(value,{
"trueValue":"1","falseValue":"0","message":"Remember Me must be either \"1\" or \"0\".","skipOnEmpty":1});
},"id":"loginform-rememberme","name":"rememberMe","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"
});
});
方法：errorSummary、validate、validateMultiple
PHP;">
public function errorSummary($models,$options = [])
它主要就是把model中的所有的错误信息汇总到一个div中。
PHP;">
public static function validate($model,$attributes = null)
public static function validateMultiple($models,$attributes = null)
3、表单中的参数
属性
$action：设置当前表单提交的URL地址，如果为空则是当前的url $method：提交方法，post或者get，默认为post $option：这个里面设置表单的其它的属性，如id等，如果没有设置id，将会自动生成一个以$autoIdPrefix为前缀的自动增加的id
_id === null) {
$this->_id = self::$autoIdPrefix . self::$counter++;
}
return $this->_id;
}
属性
Yii生成的每个field由4部分组成：
① 最外层div为每个field的容器， ② label为每个field的文本说明， ③ input为输入元素， ④ 还有一个div为错误提示信息。
required has-error">
