以下是Yii自己官方的解释,其中参杂自己的理解与举例
#checkBox()
方法
public string
checkBox(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的复选框 |
- 为模型属性渲染出一个复选框
1
2
|
// 代码部分
<?php
echo
$form
->checkBox(
$app
,
'name'
,
array
(
'class'
=>
'input'
)); ?>
|
#checkBoxList()
方法
public string
checkBoxList(
CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$data | array | 用于生成复选框组的选项的数据 (value=>display) |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的下拉列表框 |
- 为模型属性渲染出一个复选框组
1
2
3
4
5
6
7
8
9
10
|
// 代码部分
<!?php
echo
$form
->checkBoxList(
$app
,
'name'
,
array
(
/*此处写复选框集合值*/
1 =>
'pig'
,
2 =>
'cat'
,
3 =>
'dog'
) ,
array
(
/*此处写表单属性*/
'template'
=>
'{input} {label}'
,
'separator'
=>
' '
,
)); ?>
|
$model | CModel | 数据模型 |
$attribute | string | 属性 |
$data | array | 用于生成复选框列表的值-标签对。 注意,值会被自动HTML编码,而标签不会。 |
$htmlOptions | array | 附加的HTML选项。 选项将会应用于每个复选框。下面指定的选项是被认可的:
|
{return} | string | 生成的复选框列表 |
#dropDownList()
方法
public string
dropDownList(
CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$data | array | 用于生成列表的选项的数据 (value=>display) |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的下拉列表框 |
- 为模型属性渲染出一个下拉列表框
1
2
3
4
5
6
7
8
|
// 代码部分
<?php
echo
$form
->dropDownList(
$app
,
'name'
,
array
(
''
=>
'请选择'
,
'1'
=>
'love'
,
'2'
=>
'i'
,
'3'
=>
'you'
,
'4'
=>
'too'
,
),
array
(
'class'
=>
'input'
));?>
|
$model | CModel | 数据模型 |
$attribute | string | 属性 |
$data | array | 生成列表选项的数据(值=>显示) 你可以使用listData来生成这个数据。 请参阅listOptions来了解这个数据如何生成列表数据。 注意,这里的值个标签会自动被这个方法进行HTML编码。 |
$htmlOptions | array | 附加的HTML属性。除了正常的HTML属性外, 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 此外,下面的这属性也被支持:
|
{return} | string | 生成的下拉列表 |
#error()
方法
public string
error(
CModel $model, string $attribute, array $htmlOptions=array ( ), boolean $enableAjaxValidation=true, boolean $enableClientValidation=true)
| ||
$model | CModel | 模型数据 |
$attribute | string | 属性名称 |
$htmlOptions | array | 附加到div容器的标签的HTML属性。 除了所有在CHtml::error中可用的选项之外,下列选项也可以被识别:
当客户端验证可用,一个名为“clientValidation”的选项也可被识别。 这个选项设置一段JavaScript代码片段以执行客户端验证,在代码中, 预定义了下列变量:
|
$enableAjaxValidation | boolean | 是否使指定的属性的AJAX验证可用。 注意:要使AJAX验证可用,enableAjaxValidation 和这个参数都必须 设置为真。 |
$enableClientValidation | boolean | 是否使指定的属性的客户端验证可用。 注意:要使AJAX验证可用,enableClientValidation 和这个参数都必须 设置为真。此参数自1.1.7版开始可用。 |
{return} | string | 验证结果(显示错误或成功消息。) |
- 显示一个模型属性的第一个验证错误
#errorSummary()
方法
public string
errorSummary(mixed $models, string $header=NULL, string $footer=NULL, array $htmlOptions=array ( ))
| ||
$models | mixed | 要显示输入错误的模型。可以是一个 单独的模型,也可以是多个模型组成的一个数组。 |
$header | string | 在错误信息之前被显示的一段HTML代码。 |
$footer | string | 在错误信息之后被显示的一段HTML代码。 |
$htmlOptions | array | 用于渲染div容器标签的附加HTML属性。 |
{return} | string | 错误信息汇总。如果不存在任何错误,则返回空。 |
- 显示一个模型或多个模型的汇总的验证错误信息
#fileField()
方法
public string
fileField(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的文件上传控件 |
- 为模型属性渲染出一个文件上传控件
1
2
|
// 代码部分
<?php
echo
$form
->fileField(
$app
,
'name'
,
array
(
'class'
=>
'input'
)); ?>
|
#hiddenField()
方法
public string
hiddenField(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的隐藏域 |
- 为模型属性渲染出一个影藏域
1
2
|
// 代码部分
<?php
echo
$form
->hiddenField(
$app
,
'name'
,
array
(
'class'
=>
'input'
)); ?>
|
#label()
方法
public string
label(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 模型的属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 产生的Label标签。 |
- 为模型属性渲染出一个HTML Label标签
#labelEx()
方法
public string
labelEx(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的Label标签 |
- 为模型属性渲染出一个HTML Label标签(label升级版,当该元素为必填项时,会出现相应的样式)
#listBox()
方法
public string
listBox(
CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$data | array | 用于生成列表的选项的数据 (value=>display) |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的列表框 |
- 为模型属性渲染出一个列表框
1
2
3
4
5
6
7
8
|
// 代码部分
<?php
echo
$form
->listBox(
$app
,
'name'
,
array
(
''
=>
'请选择'
,
'1'
=>
'love'
,
'2'
=>
'i'
,
'3'
=>
'you'
,
'4'
=>
'too'
,
),
array
(
'class'
=>
'input'
));?>
|
passwordField()
方法
public string
passwordField(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的密码框 |
- 为模型属性渲染出一个密码框
1
2
|
// 代码部分
<?php
echo
$form
->passwordField(
$app
,
'name'
,
array
(
'class'
=>
'input'
)); ?>
|
radioButton()
方法
public string
radioButton(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的单选按钮 |
- 为模型属性渲染出一个单选按钮
1
2
|
// 代码部分
<?php
echo
$form
->radioButton(
$app
,
'name'
,
array
(
'class'
=>
'input'
)); ?>
|
radioButtonList()
方法
public string
radioButtonList(
CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$data | array | 用于生成单选按钮组的选项的数据 (value=>display) |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的单选按钮组 |
- 为模型属性渲染出一个单选按钮组
1
2
3
4
5
6
7
8
|
// 代码部分
<?php
echo
$form
->listBox(
$app
,
'name'
,
array
(
''
=>
'请选择'
,
'1'
=>
'love'
,
'2'
=>
'i'
,
'3'
=>
'you'
,
'4'
=>
'too'
,
),
array
(
'separator'
=>
' '
));?>
|
$model | CModel | 数据模型 |
$attribute | string | 属性 |
$data | array | 用于生成单选按钮列表的值-标签对。 注意,值会被自动HTML编码,而标签不会。 |
$htmlOptions | array | 附加的HTML选项。 选项将会应用于每个单选按钮。下面指定的选项是被认可的:
|
{return} | string | 生成的单选按钮列表 |
textArea()
方法
public string
textArea(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的多行文本输入控件 |
- 为模型属性渲染出一个多行文本输入的控件
1
2
|
// 代码部分
<?php
echo
$form
->textArea(
$app
,
'name'
,
array
(
'class'
=>
'input'
)); ?>
|
textField()
方法
public string
textField(
CModel $model, string $attribute, array $htmlOptions=array ( ))
| ||
$model | CModel | 模型 |
$attribute | string | 属性 |
$htmlOptions | array | 附加的HTML属性 |
{return} | string | 生成的输入框 |
- 为模型属性渲染出一个输入框
1
2
|
// 代码部分
<?php
echo
$form
->textField(
$app
,
'name'
,
array
(
'class'
=>
'input'
)); ?>
|
请大家尊重原创,本文也花费了不少心思,转发请写明出处
@让我们一起共同努力~