| 包 | system.gii |
|---|---|
| 继承 | class CCodeForm » CActiveForm » CWidget » CBaseController » CComponent |
| 源自 | 1.1.2 |
| 版本 | $Id: CCodeForm.php 2799 2011-01-01 19:31:13Z qiang.xue $ |
| 源码 |
CCodeForm表示一个用来收集生成代码所需参数的表单。
公共属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| action | mixed | 表单动作的URL (参见CHtml::normalizeUrl以了解更多关于此参数的细节)。 如果未设置，将使用当前页面的URL。 | CActiveForm |
| actionPrefix | string | actions的ID的前缀。 当微件在CController::actions中声明了 动作提供者，可以为其动作的ID指定前缀以区别 于别的微件或控制器。当微件用于控制器 的视图中时，必须配置同样的前缀。 | CWidget |
| clientOptions | array | 传递给JavaScript验证插件的选项数组。
目前支持下列选项：
|
CActiveForm |
| controller | CController | 返回此微件所属的控制器。 | CWidget |
| enableAjaxValidation | boolean | 是否使基于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();
}
.
|
CActiveForm |
| enableClientValidation | boolean | 是否使客户端验证可用。默认值是false。
当此属性设置为true，支持它的验证器将执行客户端验证。 （参见CValidator::enableClientValidation和CValidator::clientValidateAttribute。） |
CActiveForm |
| errorMessageCssClass | string | 错误信息的CSS类。默认值是“errorMessage”。 个体的error调用可以通过指定“class”HTML选项来覆盖这个值。 | CActiveForm |
| focus | mixed | 页面载入时初始化获取输入焦点的表单元素。
默认值是null，表示没有输入域拥有焦点。 如果设置为数组，第一个元素是模型，第二个元素是属性。 如果设置为字符串，那么将作为jQuery的选择器使用。 示例 - 设置页面载入时的输入焦点：
|
CActiveForm |
| htmlOptions | array | additional 渲染表单标签的HTML属性。 | CActiveForm |
| id | string | 返回此微件的ID。如果需要的话，将生产一个新的ID并将其返回。 | CWidget |
| method | string | 表单提交的方式。可以是“post”或“get”。 默认值是“post”。 | CActiveForm |
| model | CCodeModel与此表单相关的代码模型 | CCodeForm | |
| owner | CBaseController | 返回此微件的所有者或创建者。 | CWidget |
| skin | mixed | 微件使用的皮肤的名称。默认为“default”。 如果此属性设置为false，微件将不会有皮肤被使用。 | CWidget |
| stateful | boolean | 是否生成有状态的表单（参见CHtml::statefulForm）。默认值是false。 | CActiveForm |
| viewPath | string | 返回包含此微件所需的视图文件的路径。 | CWidget |
受保护属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| attributes | array | 用于模型属性的javascript选项 (input ID => options) | CActiveForm |
| summaryID | string | 包含汇总的错误信息的元素的ID | CActiveForm |
公共方法
属性详细
model
属性
public CCodeModel与此表单相关的代码模型 $model;
方法详细
init()
方法
|
public void init()
|
public function init()
{
echo <<<EOD
<div class="form gii">
<p class="note">
Fields with <span class="required">*</span> are required.
Click on the <span class="sticky">highlighted fields</span> to edit them.
</p>
EOD;
parent::init();
}
初始化此微件。 此方法渲染表单的开始标签。
run()
方法
|
public void run()
|
public function run()
{
$templates=array();
foreach($this->model->getTemplates() as $i=>$template)
$templates[$i]=basename($template).' ('.$template.')';
$this->renderFile(Yii::getPathOfAlias('gii.views.common.generator').'.php',array(
'model'=>$this->model,
'templates'=>$templates,
));
parent::run();
echo "</div>";
}
运行此微件。