| 包 | 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 |
公共方法
| 方法 | 描述 | 定义在 |
|---|---|---|
| __call() | 如果类中没有调的方法名，则调用这个方法。 | CComponent |
| __construct() | 构造器。 | CWidget |
| __get() | 返回一个属性值、一个事件处理程序列表或一个行为名称。 | CComponent |
| __isset() | 检查一个属性是否为null。 | CComponent |
| __set() | 设置一个组件的属性值。 | CComponent |
| __unset() | 设置一个组件的属性为null。 | CComponent |
| actions() | 返回此widget使用的动作的列表。 | CWidget |
| asa() | 返回这个名字的行为对象。 | CComponent |
| attachBehavior() | 附加一个行为到组件。 | CComponent |
| attachBehaviors() | 附加一个行为列表到组件。 | CComponent |
| attachEventHandler() | 为事件附加一个事件处理程序。 | CComponent |
| beginCache() | Begins fragment caching. | CBaseController |
| beginClip() | Begins recording a clip. | CBaseController |
| beginContent() | Begins the rendering of content that is to be decorated by the specified view. | CBaseController |
| beginWidget() | Creates a widget and executes it. | CBaseController |
| canGetProperty() | 确定属性是否可读。 | CComponent |
| canSetProperty() | 确定属性是否可写。 | CComponent |
| checkBox() | 为一个模型属性渲染一个复选框。 | CActiveForm |
| checkBoxList() | 为一个模型属性渲染一个复选框组。 | CActiveForm |
| createWidget() | Creates a widget and initializes it. | CBaseController |
| detachBehavior() | 从组件中分离一个行为。 | CComponent |
| detachBehaviors() | 从组件中分离所有行为。 | CComponent |
| detachEventHandler() | 分离一个存在的事件处理程序。 | CComponent |
| disableBehavior() | 禁用一个附加行为。 | CComponent |
| disableBehaviors() | 禁用组件附加的所有行为。 | CComponent |
| dropDownList() | 为一个模型属性渲染一个下拉列表框。 | CActiveForm |
| enableBehavior() | 启用一个附加行为。 | CComponent |
| enableBehaviors() | 启用组件附加的所有行为。 | CComponent |
| endCache() | Ends fragment caching. | CBaseController |
| endClip() | Ends recording a clip. | CBaseController |
| endContent() | Ends the rendering of content. | CBaseController |
| endWidget() | Ends the execution of the named widget. | CBaseController |
| error() | 显示一个模型属性的第一个验证错误。 | CActiveForm |
| errorSummary() | 显示一个或多个模型的汇总的验证错误信息。 | CActiveForm |
| evaLuateExpression() | 计算一个PHP表达式，或根据组件上下文执行回调。 | CComponent |
| fileField() | 为一个模型属性渲染一个文件上传控件。 | CActiveForm |
| getController() | 返回此微件所属的控制器。 | CWidget |
| getEventHandlers() | 返回一个事件的附加处理程序列表。 | CComponent |
| getId() | 返回此微件的ID。如果需要的话，将生产一个新的ID并将其返回。 | CWidget |
| getOwner() | 返回此微件的所有者或创建者。 | CWidget |
| getViewFile() | 根据视图名查找视图文件。 | CWidget |
| getViewPath() | 返回包含此微件所需的视图文件的路径。 | CWidget |
| hasEvent() | 确定一个事件是否定义。 | CComponent |
| hasEventHandler() | 检查事件是否有附加的处理程序。 | CComponent |
| hasProperty() | 确定属性是否被定义。 | CComponent |
| init() | 初始化此微件。 | CCodeForm |
| label() | 为一个模型属性渲染出一个HTML Label标签。 | CActiveForm |
| labelEx() | 为一个模型属性渲染出一个HTML Label标签。 | CActiveForm |
| listBox() | 为一个模型属性渲染一个列表框。 | CActiveForm |
| passwordField() | 为一个模型属性渲染一个密码框。 | CActiveForm |
| radioButton() | 为一个模型属性渲染一个单选按钮。 | CActiveForm |
| radioButtonList() | 为一个模型属性渲染一个单选按钮组。 | CActiveForm |
| raiseEvent() | 发起一个事件。 | CComponent |
| render() | 渲染一个视图。 | CWidget |
| renderFile() | Renders a view file. | CBaseController |
| renderInternal() | Renders a view file. | CBaseController |
| run() | 运行此微件。 | CCodeForm |
| setId() | 设置此微件的ID。 | CWidget |
| textArea() | 为一个模型属性渲染一个多行的文本输入控件。 | CActiveForm |
| textField() | 为一个模型属性渲染一个输入框。 | CActiveForm |
| validate() | 验证一个或多个模型，以json格式返回结果。 | CActiveForm |
| validateTabular() | 验证一个由多个模型实例组成的数组，并将验证结果以JSON格式返回。 | CActiveForm |
| widget() | Creates a widget and executes it. | CBaseController |
属性详细
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>";
}
运行此微件。