CActiveForm

<?php $form = $this->beginWidget('CActiveForm', array(
    'id'=>'user-form',
    'enableAjaxValidation'=>true,
    'enableClientValidation'=>true,
    'focus'=>array($model,'firstName'),
)); ?>

<?php echo $form->errorSummary($model); ?>

<div class="row">
    <?php echo $form->labelEx($model,'firstName'); ?>
    <?php echo $form->textField($model,'firstName'); ?>
    <?php echo $form->error($model,'firstName'); ?>
</div>
<div class="row">
    <?php echo $form->labelEx($model,'lastName'); ?>
    <?php echo $form->textField($model,'lastName'); ?>
    <?php echo $form->error($model,'lastName'); ?>
</div>

<?php $this->endWidget(); ?>

public function actionCreate()
{
    $model=new User;
    $this->performAjaxValidation($model);
    if(isset($_POST['User']))
    {
        $model->attributes=$_POST['User'];
        if($model->save())
            $this->redirect('index');
    }
    $this->render('create',array('model'=>$model));
}

protected function performAjaxValidation($model)
{
    if(isset($_POST['ajax']) && $_POST['ajax']==='user-form')
    {
        echo CActiveForm::validate($model);
        Yii::app()->end();
    }
}

public function actionCreate()
{
    $model=new User;
    if(isset($_POST['ajax']) && $_POST['ajax']==='user-form')
    {
        echo CActiveForm::validate($model);
        Yii::app()->end();
    }
    .

属性详细

表单动作的URL (参见CHtml::normalizeUrl以了解更多关于此参数的细节)。 如果未设置，将使用当前页面的URL。

用于模型属性的javascript选项 (input ID => options)

传递给JavaScript验证插件的选项数组。 目前支持下列选项：

• ajaxVar: string, 用来指明当前请求是一个AJAX请求的参数的名字。 当AJAX验证被触发，一个以此属性值为名的参数将与其他表单数据一起被提 交到服务器。此参数的值是表单的ID。 服务器端可以检测出AJAX验证的触发者，并作出相应的反应。 默认值是“ajax”。
• validationUrl: string, 用于执行AJAX验证的URL。 如果没有设置，将使用action的值。
• validationDelay: integer, 输入被改变后延迟多少时间才执行 AJAX验证，单位是毫秒。设置为0意味着输入被改变后将立即执行AJAX 验证。设置为大于0的值意味着多个输入改变可能只触发一次AJAX验证， 只要它们发生得足够快。这种方式可以帮助降低服务器负荷。 默认值是200（0.2秒）。
• validateOnSubmit: boolean, 当表单被提交时是否执行AJAX验证。 如果存在任何验证错误，表单的提交动作将被停止。 默认值是false。
• validateOnChange: boolean, 是否每次输入值被改变都触发 一次AJAX验证。因为每次AJAX验证请求都会提交整个表单的数据， 可能会导致过多的影响性能，你可以选择关闭此选项。 默认值是true。
• validateOnType: boolean, 是否用户的每次按键动作都会触 发一次AJAX验证。如果该属性设置为true，你应该增大“validationDelay” 的值以避免触发太多的AJAX验证。默认值是false。
• hideErrorMessage: boolean, 当存在错误时是否隐藏错误提示信息。 默认值是false，表示无论是否存在输入错误，都会显示错误信息。
• inputContainer: string, 包含输入框的HTML元素的jQuery选择器。 在验证处理过程中，CActiveForm将为包含元素指定相应的CSS类以指示状 的改变。如果没有设置，默认是指包含输入框的最近的“div”元素。
• errorCssClass: string, 为包含有AJAX验证错误的输入框的HTML容器 指定的CSS类。默认值是“error”。
• successCssClass: string, 为包含通过了AJAX验证成功的输入框的HTML 容器指定的CSS类。默认值是“success”。
• validatingCssClass: string, 为包含正在进行AJAX验证的输入框的 HTML容器指定的CSS类。默认值是“validating”。
• errorMessageCssClass: string, 为AJAX验证返回的错误提示信息 指定的CSS类。默认值是“errorMessage”。
• beforeValidate: function, 在一个表单提交动作触发的基于AJAX的 验证执行之前被调用的函数（仅当validateOnSubmit设置为true时可用）。 预期的函数签名形如beforeValidate(form) {...}，这儿“form” 是form对象的jQuery表示。如果此函数的返回值不为true，验证将会被取 消。
  
  注意：因为此选项指向一个JavaScript函数，你应该为它增加一个“js:”前缀， 以避免它被作为一个字符串编码。此选项从1.1.3版开始被支持。
• afterValidate: function, 在一个表单提交动作触发的基于AJAX的 验证执行之后被调用的函数（仅当validateOnSubmit设置为true时可用）。 预期的函数签名形如afterValidate(form, data, hasError) {...}， 这儿“form”是form对象的jQuery表示；“data”是服务器端验证响应的JSON格式的数据； “hasError”是一个布尔值，它指示是否存在任何验证错误。如果此函数的返回值不是true， 相应的表单提交将会被取消。
  
  注意：因为此选项指向一个JavaScript函数，你应该为它增加一个“js:”前缀， 以避免它被作为一个字符串编码。此选项从1.1.3版开始被支持。
• beforeValidateAttribute: function, 当一个单独的属性的输入框 发生改变时触发的AJAX验证执行之前被调用的函数。预期的函数签名形如 beforeValidateAttribute(form, attribute) {...}, 这儿“form”是form对象的jQuery表示；“attribute”指向触发的属性的js选项（参见error）。 如果此函数的返回值不为true，验证将会被取消。
  
  注意：因为此选项指向一个JavaScript函数，你应该为它增加一个“js:”前缀， 以避免它被作为一个字符串编码。此选项从1.1.3版开始被支持。
• afterValidateAttribute: function, 当一个单独的属性的输入框 发生改变时触发的AJAX验证执行之后被调用的函数。预期的函数签名形如 afterValidateAttribute(form, attribute, data, hasError) {...}, 这儿“form”是form对象的jQuery表示; “attribute”指向触发的属性的js选项 （参见error）； “data”是服务器端验证响应的JSON格式的数据；“hasError”是一个布尔值， 它指示是否存在任何验证错误。
  
  注意：因为此选项指向一个JavaScript函数，你应该为它增加一个“js:”前缀， 以避免它被作为一个字符串编码。此选项从1.1.3版开始被支持。

是否使基于AJAX的验证可用。默认值是false。 当此属性设置为true，你应当象下面这样在服务器端对AJAX验证请求作出响应：

public function actionCreate()
{
    $model=new User;
    if(isset($_POST['ajax']) && $_POST['ajax']==='user-form')
    {
        echo CActiveForm::validate($model);
        Yii::app()->end();
    }
    ......
}

是否使客户端验证可用。默认值是false。

当此属性设置为true，支持它的验证器将执行客户端验证。 （参见CValidator::enableClientValidation和CValidator::clientValidateAttribute。）

错误信息的CSS类。默认值是“errorMessage”。 个体的error调用可以通过指定“class”HTML选项来覆盖这个值。

页面载入时初始化获取输入焦点的表单元素。

默认值是null，表示没有输入域拥有焦点。 如果设置为数组，第一个元素是模型，第二个元素是属性。 如果设置为字符串，那么将作为jQuery的选择器使用。

示例 - 设置页面载入时的输入焦点：

• 'focus'=>array($model,'username') - $model->username 输入框
• 'focus'=>'#'.CHtml::activeId($model,'username') - $model->username 输入框
• 'focus'=>'#LoginForm_username' - ID为“LoginForm_username”的输入框
• 'focus'=>'input[type="text"]:first' - 第一个type="text"的input元素
• 'focus'=>'input:visible:enabled:first' - 第一个可见的，可用的input元素
• 'focus'=>'input:text[value=""]:first' - 第一个空的input元素

additional 渲染表单标签的HTML属性。

表单提交的方式。可以是“post”或“get”。 默认值是“post”。

是否生成有状态的表单（参见CHtml::statefulForm）。默认值是false。

包含汇总的错误信息的元素的ID

方法详细

为一个模型属性渲染一个复选框。 这个方法是CHtml::activeCheckBox的一个包装。 请参见CHtml::activeCheckBox以了解 关于此方法的参数的更多详细信息。

为一个模型属性渲染一个复选框组。 这个方法是CHtml::activeCheckBoxList的一个包装。 请参见CHtml::activeCheckBoxList以了解 关于此方法的参数的更多详细信息。

为一个模型属性渲染一个下拉列表框。 这个方法是CHtml::activeDropDownList的一个包装。 请参见CHtml::activeDropDownList以了解 关于此方法的参数的更多详细信息。

显示一个模型属性的第一个验证错误。 这个方法类似于CHtml::error，不同之处是它注册了模型属性 所以当用户改变了它的值，可能会触发一个AJAX验证。

显示一个或多个模型的汇总的验证错误信息。 这个方法类似于CHtml::errorSummary，不同之处是 当执行AJAX验证时它同样可以工作。

为一个模型属性渲染一个文件上传控件。 这个方法是CHtml::activeFileField的一个包装。 请参见CHtml::activeFileField以了解 关于此方法的参数的更多详细信息。

为一个模型属性渲染一个隐藏域。 这个方法是CHtml::activeHiddenField的一个包装， 请参见CHtml::activeHiddenField以了解 关于此方法的参数的更多详细信息。

初始化widget。 此方法渲染表单的开始标签。

为一个模型属性渲染出一个HTML Label标签。 这个方法是CHtml::activeLabel的一个包装。 请参见CHtml::activeLabel以了解更多关于 这个方法的参数的信息。

为一个模型属性渲染出一个HTML Label标签。 这个方法是CHtml::activeLabelEx的一个包装。 请参见CHtml::activeLabelEx以了解关于此方法 的参数的更多详细信息。

为一个模型属性渲染一个列表框。 这个方法是CHtml::activeListBox的一个包装。 请参见CHtml::activeListBox以了解 关于此方法的参数的更多详细信息。

为一个模型属性渲染一个密码框。 这个方法是CHtml::activePasswordField的一个包装。 请参见CHtml::activePasswordField以了解 关于此方法的参数的更多详细信息。

为一个模型属性渲染一个单选按钮。 这个方法是CHtml::activeRadioButton的一个包装。 请参见CHtml::activeFileField以了解 关于此方法的参数的更多详细信息。

为一个模型属性渲染一个单选按钮组。 这个方法是CHtml::activeRadioButtonList的一个包装。 请参见CHtml::activeRadioButtonList以了解 关于此方法的参数的更多详细信息。

运行widget。 这个方法注册必要的javascript代码，渲染表单结束标签。

为一个模型属性渲染一个多行的文本输入控件。 这个方法是CHtml::activeTextArea的一个包装。 请参见CHtml::activeTextArea以了解 关于此方法的参数的更多详细信息。

为一个模型属性渲染一个输入框。 这个方法是CHtml::activeTextField的一个包装。 请参见CHtml::activeTextField以了解 关于此方法的参数的更多详细信息。

验证一个或多个模型，以JSON格式返回结果。 这是一个用于简化编写AJAX验证代码的方式的助手方法。

验证一个由多个模型实例组成的数组，并将验证结果以JSON格式返回。 这是一个用于简化编写表格式输入的AJAX验证代码的方式的助手方法。