Yii Framework v1.1.10 类参考

CHtml

包	system.web.helpers
继承	class CHtml
源自	1.0
版本	$Id: CHtml.php 3515 2011-12-28 12:29:24Z mdomba $
源码	framework/web/helpers/CHtml.php

属性详细

加在必填项标签后面的HTML代码。

加在必填项标签前面的HTML代码。

产生自动输入栏位名称的计数器。

高亮错误输出的CSS类。 如果有错误输入的话，表单输入控件将附加上这个CSS类。

显示错误消息的CSS类。(请参阅 error).

显示错误摘要的CSS类。(请参阅 errorSummary).

设置附加jQuery的事件处理程序的默认样式。

如果设置为true（默认），则使用live/delegated样式。 事件处理程序被附加到body后面， 来处理在稍后的时间添加到body的子元素上的事件。

如果设置为false，则使用直接的方式。 事件处理程序直接附加到DOM元素上面，元素必须是已经在页面上存在的。 在晚些时间注入到页面的元素不被处理。

你可以为某个特定的元素设置htmlOption中live属性来覆盖这个设置。 (请参阅 clientChange).

更多关于附加jQuery事件处理程序的信息，请参阅http://api.jquery.com/on/

必填项标签的CSS类。默认为'required'。

方法详细

public static string activeCheckBox(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 一个名为'uncheckValue'的选项是可用的， 当复选框没有被选中时可以返回这个选项的值。这个值默认为0。 在内部，一个隐藏域会被渲染，以便当复选框没有被选中时， 我们仍然能获取到未选中的值。 如果'uncheckValue'被设置为NULL，隐藏域将不会被渲染。
{return}	string	生成的复选框

为模型属性生成一个复选框。 属性被假定是true或false。 如果该属性有输入错误， 输入栏的CSS类会被附加上errorCss。

public static string activeCheckBoxList(CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$data	array	用于生成复选框列表的值-标签对。 注意，值会被自动HTML编码，而标签不会。
$htmlOptions	array	附加的HTML选项。 选项将会应用于每个复选框。下面指定的选项是被认可的： template: 字符串，指定如何渲染每个复选框。 默认为"{input} {label}"， 其中"{input}"将被生成的复选框标签取代， 而"{label}"会替换为相应的复选框标签的label。 separator: 字符串，分隔生成的复选框的字符串。 checkAll: 字符串，"check all"复选框指定的标签。 如果指定这个选项，一个'check all'复选框将会显示。 点击这个复选框将会将所有的复选框全选或全不选。 checkAllLast: 布尔值，指定是否在筛选框列表后面显示一个'check all'复选框。 如果没有设置这个选项（默认）， 或者设置为false， 'check all'复选框将会显示在复选框列表的前面。 encode: 布尔型，指定是否对标签属性和值进行HTML编码，默认为true。 自1.1.7版起，一个名称为‘uncheckValue’的特殊选项可以被使用， 这个特殊选项的值在当单选按钮没有被选中时返回。 如果设置了这个特殊选项值，那么一个隐藏域会被渲染，以便当单选按钮没有被选中时，我们仍然可以获得一个未选中时的值。 如果‘uncheckValue’没有被设置或设置为NULL，隐藏域将不会被渲染。
{return}	string	生成的复选框列表

为一个模型属性生成一个复选框列表。 模型的属性值用来作为选项。 如果该属性有输入错误， 输入栏的CSS类会被附加上errorCss。 注意一个复选框列表允许多选。就像listBox. 结果，相应的POST值是一个数组。 万一没有选择的话，相应的POST值是一个空字符串。

public static string activeDropDownList(CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$data	array	生成列表选项的数据(值=>显示) 你可以使用listData来生成这个数据。 请参阅listOptions来了解这个数据如何生成列表数据。 注意，这里的值个标签会自动被这个方法进行HTML编码。
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 此外，下面的这属性也被支持： encode: 布尔值，是否对值进行编码。默认为true。 prompt: 字符串，指定的作为第一个列表选项的提示文本。它的值为空。注意，提示文本不会被HTML编码。 empty: 字符串，指定空选项的文本，它的值为空。 'empty'选项也可以是一个值-标签对形式的数组。 在一开始每个对都会用于渲染一个列表的选项。注意，文本标签不会被HTML编码。 options: 数组，为每个OPTION标签额外指定的属性。 数组的键名必须是选项的值， 数组的键值是选项标签的额外的属性，名称-值对的形式。例如， array( 'value1'=>array('disabled'=>true, 'label'=>'value 1'), 'value2'=>array('label'=>'value 2'), );
{return}	string	生成的下拉列表

为一个模型属性生成一个下拉列表。 如果该属性有输入错误， 输入栏的CSS类会被附加上errorCss。

public static string activeFileField(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	额外的HTML属性(请参阅tag).
{return}	string	生成的文件输入框

为一个模型属性生成一个文件输入框。 注意，你必须设置表单的‘enctype’属性为‘multipart/form-data’。 表单被提交后，上传的文件信息可以通过$_FILES[$name]来获得 (请参阅 PHP documentation).

public static string activeHiddenField(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	额外的HTML属性
{return}	string	生成的隐藏域

为模型属性生成一个隐藏域。

public static string activeId(CModel $model, string $attribute)
$model	CModel	数据模型
$attribute	string	属性
{return}	string	生成的输入栏的ID

为模型属性生成一个输入栏的ID。

protected static string activeInputField(string $type, CModel $model, string $attribute, array $htmlOptions)
$type	string	输入类型(例如'text', 'radio')
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	输入标签的额外的HTML属性
{return}	string	生成的输入标签

为一个模型属性生成一个输入标签。 这个方法会依据给定的数据模型和属性来生成一个输入标签。 如果属性有输入错误， 输入栏的CSS类将被附加上errorCss。 这个可以高亮错误的输入。

public static string activeLabel(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	额外的HTML属性。下面指定选项是被认可的： required: 如果设置了且为true， 那么标签将会设置为CSS类'required' (可由CHtml::$requiredCss定制)， 可以用CHtml::beforeRequiredLabel和 CHtml::afterRequiredLabel来装饰。 label: 指定要显示的标签。如果没有设置， CModel::getAttributeLabel将被调用来获取要用于显示的标签。 如果标签被指定为false，那么将不会有标签被渲染。
{return}	string	生成的label标签

为模型属性生成一个label标签。 标签的文本是模型属性的标签， 标签和input的属性有关(请参阅CModel::getAttributeLabel。 如果属性有输入错误，标签的CSS类会附加上errorCss.

public static string activeLabelEx(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	额外的HTML属性
{return}	string	生成的label标签

为模型属性生成一个label标签。 这是一个加强版的activeLabel。 当属性是必填的时候，它将渲染额外的CSS类个标记。 特别的，它调用CModel::isAttributeRequired来决定 属性是否为必填的。 如果是，它将添加一个CSS类CHtml::requiredCss到标签上， 用CHtml::beforeRequiredLabel和CHtml::afterRequiredLabel 来装饰标签。

public static string activeListBox(CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$data	array	生成列表选项的数据(值=>显示) 你可以使用listData来生成这个数据。 请参阅listOptions来了解这个数据如何生成列表数据。 注意，这里的值个标签会自动被这个方法进行HTML编码。
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 此外，下面的这属性也被支持： encode: 布尔值，是否对值进行编码。默认为true。 prompt: 字符串，指定的作为第一个列表选项的提示文本。它的值为空。注意，提示文本不会被HTML编码。 empty: 字符串，指定空选项的文本，它的值为空。 'empty'选项也可以是一个值-标签对形式的数组。 在一开始每个对都会用于渲染一个列表的选项。注意，文本标签不会被HTML编码。 options: 数组，为每个OPTION标签额外指定的属性。 数组的键名必须是选项的值， 数组的键值是选项标签的额外的属性，名称-值对的形式。例如， array( 'value1'=>array('disabled'=>true, 'label'=>'value 1'), 'value2'=>array('label'=>'value 2'), );
{return}	string	生成的列表框

为一个模型属性生成一个列表框。 模型的属性值用来作为选项。 如果该属性有输入错误， 输入栏的CSS类会被附加上errorCss。

public static string activeName(CModel $model, string $attribute)
$model	CModel	数据模型
$attribute	string	属性
{return}	string	生成的输入栏名称

为一个模型属性生成输入栏名称。 不同于resolveName，这个方法不用修改属性名。

public static string activePasswordField(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的密码输入框

为一个模型属性生成一个密码输入框。 如果该属性有输入错误， 输入栏的CSS类将会被附加上errorCss。

public static string activeRadioButton(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 一个名为'uncheckValue'的选项是可用的， 当单选按钮没有被选中时可以返回这个选项的值。这个值默认为0。 在内部，一个隐藏域会被渲染，以便当单选按钮没有被选中时， 我们仍然能获取到未选中的值。 如果'uncheckValue'被设置为NULL，隐藏域将不会被渲染。
{return}	string	生成的单选按钮

为模型属性生成一个单选按钮。 如果该属性有输入错误， 输入栏的CSS类会被附加上errorCss。

public static string activeRadioButtonList(CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$data	array	用于生成单选按钮列表的值-标签对。 注意，值会被自动HTML编码，而标签不会。
$htmlOptions	array	附加的HTML选项。 选项将会应用于每个单选按钮。下面指定的选项是被认可的： template: 字符串，指定如何渲染每个复选框。 默认为"{input} {label}"， 其中"{input}"将被生成的单选按钮标签取代， 而"{label}"会替换为相应的单选按钮标签的label。 separator: 字符串，分隔生成的单选按钮的字符串。默认为一个新行（ ） encode: 布尔型，指定是否对标签属性和值进行HTML编码，默认为true。 自1.1.7版起，一个名为'uncheckValue'的选项可用。 当没有单选按钮被选中时它返回一个特定的值。默认为''。 在内部，一个隐藏域会被渲染，当没有单选按钮被选中时，我们仍然可以获取一个POST值。 如果'uncheckValue'设置为NULL，隐藏域将不会被渲染。
{return}	string	生成的单选按钮列表

为一个模型属性生成一个单选按钮列表。 模型的属性值用来作为选项。 如果该属性有输入错误， 输入栏的CSS类会被附加上errorCss。

public static string activeTextArea(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的文本框

为一个模型属性生成一个文本框。 如果该属性有输入错误， 输入栏的CSS类会被附加上errorCss。

public static string activeTextField(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的文本框

为模型属性生成一个文本框。 如果属性有输入错误， 输入框的CSS类将会附加上errorCss.

protected static void addErrorCss(array &$htmlOptions)
$htmlOptions	array	要被修改的HTML选项

添加errorCss到'class'属性。

public static string ajax(array $options)
$options	array	AJAX选项。jQuery的AJAX文档中指定了有效的选项。 为了方便起见，下面指定的选项被添加： update: 字符串，指定的选择器， 它的HTML内容将会被AJAX的请求结果所代替。 replace: 字符串，指定的选择器， 会被AJAX的请求结果所代替。 注意，如果你指定了'success'选项，那么上面的设置会被忽略。
{return}	string	生成的JavaScript

生成启动AJAX请求的JavaScript。

public static string ajaxButton(string $label, mixed $url, array $ajaxOptions=array ( ), array $htmlOptions=array ( ))
$label	string	按钮的标签
$url	mixed	AJAX请求的URL。如果是空，那就假定为当前的URL。更多详细情况请参见normalizeUrl。
$ajaxOptions	array	AJAX options (see ajax)
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的按钮

生成一个可以发起AJAX请求的按钮。

public static string ajaxLink(string $text, mixed $url, array $ajaxOptions=array ( ), array $htmlOptions=array ( ))
$text	string	链接主体（不会被HTML编码）
$url	mixed	AJAX请求的URL。如果是空，那就假定为当前的URL。更多详细信息请参见normalizeUrl。
$ajaxOptions	array	AJAX选项 (请参阅ajax)
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的链接

生成一个可以发起AJAX请求的链接。

public static string ajaxSubmitButton(string $label, mixed $url, array $ajaxOptions=array ( ), array $htmlOptions=array ( ))
$label	string	按钮的标签
$url	mixed	AJAX请求的URL。如果是空，那就假定为当前的URL。更多详细信息请参见normalizeUrl。
$ajaxOptions	array	AJAX选项(请参阅ajax)
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的按钮

生成一个可以用POST方法提交当前表单的按钮。

public static string asset(string $path, boolean $hashByName=false)
$path	string	发布的资源路径
$hashByName	boolean	公布的目录是否应该被命名为哈希文档名。 如果为false，该名称将是发布路径的哈希目录名。 默认为false。 如果想在不同扩展之间共享发布路径，那么就设置为true。
{return}	string	公共资源的URL

生成公共资源的URL。

public static string beginForm(mixed $action='', string $method='post', array $htmlOptions=array ( ))
$action	mixed	表单的action链接(关于这个参数详见normalizeUrl。)
$method	string	表单方法(例如 post, get)
$htmlOptions	array	附加的HTML属性(请参阅tag)。
{return}	string	生成的表单标签。

生成一个表单的开始标签。 注意，仅生成表单的开始标签。 闭合的标签应该在表单末尾手动添加。

public static string button(string $label='button', array $htmlOptions=array ( ))
$label	string	按钮的标签
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的按钮标签

生成一个按钮。

public static string cdata(string $text)
$text	string	要被密封的字符串
{return}	string	含有密封内容的CDATA标签。

将一个给定的字符串密封进一个CDATA标签中。

public static string checkBox(string $name, boolean $checked=false, array $htmlOptions=array ( ))
$name	string	复选框的名称
$checked	boolean	复选框是否为被选中状态
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 自1.1.2版起，一个名称为‘uncheckValue’的特殊选项可以被使用， 这个特殊选项的值在当复选框没被选中时返回。 如果设置了这个特殊选项值，那么一个隐藏域会被渲染，以便当复选框没有被选中时，我们仍然可以获得一个未选中时的值。 如果‘uncheckValue’没有被设置或设置为NULL，隐藏域将不会被渲染。
{return}	string	生成的复选框

生成一个复选框。

public static string checkBoxList(string $name, mixed $select, array $data, array $htmlOptions=array ( ))
$name	string	复选框列表的名称。 一旦表单被提交，你可以就这个名称来获取选中的值。
$select	mixed	复选框列表的选中项。 这个可以是一个单独的被选中项的字符串，也可以是多个选中项的数组。
$data	array	用于生成复选框列表的值-标签对。 注意，值将自动被HTML编码，然而标签不会。
$htmlOptions	array	附加的HTML选项。 选项将会应用于每个复选框上，下面这些特定的选项是被认可的： template: 字符串，指定如何渲染每个复选框。 默认为"{input} {label}"， 其中"{input}"将被生成的复选框标签取代， 而"{label}"会替换为相应的复选框标签的label。 separator: 字符串，分隔生成的复选框的字符串。 checkAll: 字符串，"check all"复选框指定的标签。 如果指定这个选项，一个'check all'复选框将会显示。 点击这个复选框将会将所有的复选框全选或全不选。 checkAllLast: 布尔值，指定是否在筛选框列表后面显示一个'check all'复选框。 如果没有设置这个选项（默认）， 或者设置为false， 'check all'复选框将会显示在复选框列表的前面。 labelOptions: 数组， 指定为列表中的每个标签渲染的附加的HTML属性。
{return}	string	生成的复选框列表

生成一个复选框列表。 一个允许多选的复选框列表，比如listBox. 作为一个结果，相对的POST值是一个数组。

protected static void clientChange(string $event, array &$htmlOptions)
$event	string	事件名(不带'on')
$htmlOptions	array	HTML属性，可能包含以下 特殊属性来指定客户端改变行为： submit: 字符串，指定该按钮应该提交的URL。如果为空，当前请求的URL将被使用。 params: 数组，名称-值对的形式，应该和表单一起提交。这仅用于'submit'选项被指定的时候。 csrf: 布尔值，当CHttpRequest::enableCsrfValidation为true时，是否提交一个CSRF令牌。默认为false。 当元素周围没有表单时，你可能会设置这个为true。 这个选项仅当'sumit'选项设置时才有意义。 return: 布尔值，返回值是javascript。默认为false， 意味着javascript的结果将不能引起事件的默认行为。 confirm: 字符串，指定显示在弹出的对话框中的信息。 ajax: 数组，指定的AJAX选项(请参阅ajax)。 live: 布尔值，事件处理程序应该附加live/delegate样式还是用直接的样式。如果没有设置，liveEvents将会被使用，这个选项自1.1.6版可用。 这个参数自1.1.1版就已经可用。

生成JavaScript与指定的客户端变化。

public static string closeTag(string $tag)
$tag	string	标签名
{return}	string	生成的HTML元素标签

生成一个HTML元素的结束标记

public static string css(string $text, string $media='')
$text	string	CSS内容
$media	string	这个CSS适用于的media。
{return}	string	密封好的CSS

将给定的CSS内容密封到一个CSS标签中。

public static string cssFile(string $url, string $media='')
$url	string	CSS的URL
$media	string	CSS应用的media。
{return}	string	CSS链接

特定的CSS文件的链接。

public static string decode(string $text)
$text	string	要被解码的数据
{return}	string	解码后的数据

把特殊的HTML实体解码为相对应的字符。 这个和encode()是相反的功能。

public static string dropDownList(string $name, string $select, array $data, array $htmlOptions=array ( ))
$name	string	下拉列表的名称
$select	string	被选中的值
$data	array	用来生成列表选项的数据(值=>显示). 你可以使用listData来生这个数据。 请参考listOptions来了解这个数据如何生成列表选项。 注意，这个方法会自动的将值和标签HTML编码。
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 此外，下面这些选项也被下拉列表所支持： encode: 布尔值，指定是否对值进行编码。默认为true。 prompt: 字符串，指定作为第一个列表项的提示文本，它的值是空的。注意，提示文本不会被HTML编码。 empty: 字符串，指定空选项的文本，它的值是空的。 ‘empty’选项也可以是一个值-标签对的数组。 每一对都将在一开始渲染为一个列表选项。注意，文本标签不会被HTML编码。 options: 数组，每个option标签的指定附加属性。 数组的键名必须是option的值， 数组的键值是option标签的附加的属性。例如， array( 'value1'=>array('disabled'=>true, 'label'=>'value 1'), 'value2'=>array('label'=>'value 2'), );
{return}	string	生成的下拉列表

生成一个下拉列表。

public static string encode(string $text)
$text	string	要被编码的数据
{return}	string	编码后的数据

把特殊的字符编码为HTML实体。 application charset将被用于编码。

public static array encodeArray(array $data)
$data	array	要被编码的数据
{return}	array	编码后的数据

把一个字符串数组中的特殊字符编码为HTML实体。 如果需要的话，数组的键名和键值都将被编码。 如果键值是一个数组，这个方法也将递归的将它编码 application charset将被用于编码。

public static string endForm()
{return}	string	生成的标签

生成一个表单的结束标签。

public static 数据显示字符串。如果没有发现错误则为空。 error(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model	CModel	数据模型
$attribute	string	属性名
$htmlOptions	array	额外的被渲染到div容器的HTML属性。
{return}	数据显示字符串。如果没有发现错误则为空。

显示一个模型属性的第一个有效的错误。

public static string errorSummary(mixed $model, string $header=NULL, string $footer=NULL, array $htmlOptions=array ( ))
$model	mixed	输入错误要被显示的模型。 可以是一个单独的模型，也可以是一个模型的数组。
$header	string	出现在错误前面的一段HTML代码
$footer	string	出现在错误后面的一段HTML代码
$htmlOptions	array	额外的被渲染到div容器的HTML属性。 一个名为'firstError'的属性是被认可的，当设置为true， 将只显示每个属性的第一个错误信息。 如果不设置或设置为false，所有的错误信息都将会显示。 这个选项自1.1.3版可用。
{return}	string	错误摘要。如果没有错误被找到则为空。

显示一个或多个模型的有效错误的摘要。

public static string fileField(string $name, string $value='', array $htmlOptions=array ( ))
$name	string	输入框的名称
$value	string	输入框的值
$htmlOptions	array	附加的HTML属性(请参阅tag).
{return}	string	生成的文件输入框

生成一个文件输入框。 注意，你必须设置表单的‘enctype’属性为‘multipart/form-data’。 表单被提交后，上传的文件信息可以通过$_FILES[$name]来获得 (请参阅 PHP documentation).

public static string form(mixed $action='', string $method='post', array $htmlOptions=array ( ))
$action	mixed	表单的action链接(关于这个参数详见normalizeUrl。)
$method	string	表单方法(例如 post, get)
$htmlOptions	array	附加的HTML属性(请参阅tag)。
{return}	string	生成的表单标签。

生成一个表单的开始标签。 这是beginForm的一个捷径。

public static string getIdByName(string $name)
$name	string	用来生成HTML ID的名称
{return}	string	根据名称生成的ID。

根据名称来生成一个有效的HTML ID。

public static string hiddenField(string $name, string $value='', array $htmlOptions=array ( ))
$name	string	输入框的名称
$value	string	输入框的值
$htmlOptions	array	附加的HTML属性(请参阅tag).
{return}	string	生成的隐藏输入框

生成一个隐藏的输入框

public static string htmlButton(string $label='button', array $htmlOptions=array ( ))
$label	string	按钮的标签。 注意，这个值将会直接的插入到按钮元素中，不经过编码处理。
$htmlOptions	array	additional 附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的按钮标签

生成一个使用HTML按钮标签的按钮。 这个方法类似于button， 只是它生成一个按钮标签来替代input标签。

public static string image(string $src, string $alt='', array $htmlOptions=array ( ))
$src	string	图片的URL
$alt	string	替代的文字显示
$htmlOptions	array	附加的HTML属性(请参阅tag).
{return}	string	生成的图片标签

生成一个图片标签。

public static string imageButton(string $src, array $htmlOptions=array ( ))
$src	string	图片的URL
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的按钮标签

生成一个图片提交按钮。

protected static string inputField(string $type, string $name, string $value, array $htmlOptions)
$type	string	input标签类型(例如 'text', 'radio')
$name	string	input标签名称
$value	string	input标签值
$htmlOptions	array	额外的HTML标签的属性(请参阅tag).
{return}	string	生成的input标签

生成一个input标签。 这个方法基于给定的名称和值来生成一个input标签。

public static string label(string $label, string $for, array $htmlOptions=array ( ))
$label	string	标签文本。注意，如果需要的话，你应该把文本HTML编码。
$for	string	和这个标签有关的HTML元素的ID。 如果是false，标签的‘for’属性将不会被渲染。
$htmlOptions	array	附加的HTML属性。 下面的HTML选项是被认可的： required: 如果设置为true， 标签的样式将会设置为CSS类'required' (可以用CHtml::$requiredCss来定制)， 也可以用CHtml::beforeRequiredLabel 和CHtml::afterRequiredLabel来装饰。
{return}	string	生成的label标签

生成一个label标签

public static string link(string $text, mixed $url='#', array $htmlOptions=array ( ))
$text	string	链接主体。它不会被编码。因此，如图像标签那样的HTML代码也会被通过。
$url	mixed	一个URL或一个路由动作，用于创建一个URL。 关于如何指定这个参数的更多详细情况请参阅normalizeUrl。
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的超链接

生成一个超链接。

public static string linkButton(string $label='submit', array $htmlOptions=array ( ))
$label	string	按钮的标签
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的按钮标签

生成一个链接提交按钮。

public static string linkTag(string $relation=NULL, string $type=NULL, string $href=NULL, string $media=NULL, array $options=array ( ))
$relation	string	link标签的rel属性。如果是null，属性将不会被生成。
$type	string	link标签的type属性。如果是null，属性将不会被生成。
$href	string	link标签的href属性。如果是null，属性将不会被生成。
$media	string	link标签的media属性。如果是null，属性将不会被生成。
$options	array	其它选项的名称-值对
{return}	string	生成的link标签

生成一个link标签，可以插入到HTML页面的头部部分。 不要把这个方法与link()相混乱，后者是生成一个超级链接。

public static string listBox(string $name, mixed $select, array $data, array $htmlOptions=array ( ))
$name	string	列表框的名称
$select	mixed	被选中的值。这个可以是一个单独的被选中项的字符串，也可以是多个选中项的数组。
$data	array	用于生成列表选项的数据(值=>显示) 你可以使用listData来生这个数据。 请参考listOptions来了解这个数据如何生成列表选项。 注意，这个方法会自动的将值和标签HTML编码。
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 此外，下面这些选项也被下拉列表所支持： encode: 布尔值，指定是否对值进行编码。默认为true。 prompt: 字符串，指定作为第一个列表项的提示文本，它的值是空的。注意，提示文本不会被HTML编码。 empty: 字符串，指定空选项的文本，它的值是空的。 ‘empty’选项也可以是一个值-标签对的数组。 每一对都将在一开始渲染为一个列表选项。注意，文本标签不会被HTML编码。 options: 数组，每个option标签的指定附加属性。 数组的键名必须是option的值， 数组的键值是option标签的附加的属性。例如， array( 'value1'=>array('disabled'=>true, 'label'=>'value 1'), 'value2'=>array('label'=>'value 2'), );
{return}	string	生成的列表框

生成一个列表框。

public static array listData(array $models, string $valueField, string $textField, string $groupField='')
$models	array	模型对象的列表。 这个参数也可以是一个关联的数组(例如CDbCommand::queryAll的结果)。
$valueField	string	列表选项值的属性名
$textField	string	列表选项文本的属性名
$groupField	string	列表选项组的属性名。如果是空，将不会生成组。
{return}	array	可用于dropDownList, listBox等的列表数据。

为列表型HTML元素生成适当的数据。 生成的数据可用于dropDownList, listBox, checkBoxList, radioButtonList,和它们的加强版(比如activeDropDownList). 注意，这个方法不会对生成的数据HTML编码。 如果需要的话你可以调用encodeArray来给它编码。 请参阅value方法来了解如何指定值字段，文本字段以及组字段。

public static string listOptions(mixed $selection, array $listData, array &$htmlOptions)
$selection	mixed	被选中的值。这个可以是一个单独的被选中项的字符串，也可以是多个选中项的数组。
$listData	array	选项数据(请参阅listData)
$htmlOptions	array	额外的HTML属性。下面两个特定的属性是被认可： encode: 布尔值，指定是否对值进行编码。默认为true。 prompt: 字符串，指定作为第一个列表选项的提示文本。它的值为空。注意，提示文本不会被HTML编码。 empty: 字符串，指定空选项的文本，它的值为空。 'empty'选项也可以是一个值-标签对形式的数组。 在一开始每个对都会用于渲染一个列表的选项。注意，文本标签不会被HTML编码。 options: 数组，为每个OPTION标签额外指定的属性。 数组的键名必须是选项的值， 数组的键值是选项标签的额外的属性，名称-值对的形式。例如， array( 'value1'=>array('disabled'=>true, 'label'=>'value 1'), 'value2'=>array('label'=>'value 2'), ); key: 字符串，指定选择对象的key属性名称specifies the name of key attribute of the selection object(s). 当作为对象实体来请求时使用。在这种情况下，This is used when the selection is represented in terms of objects. In this case, 这个用对象的选项的key来命名的属性将作为真实的选中的值。 这个选项默认为'primaryKey', 意味着使用选中实体的'primaryKey'属性值。 这个选项自1.1.3版可用。
{return}	string	生成的列表选项

生成一个列表选项。

public static string mailto(string $text, string $email='', array $htmlOptions=array ( ))
$text	string	链接主体。它不会被编码。因此，如图像标签那样的HTML代码也会被通过。
$email	string	email地址。如果是空，第一个参数（链接主体）将被作为email地址。
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	the 生成的电子邮件链接

创建一个电子邮件链接。

public static string metaTag(string $content, string $name=NULL, string $httpEquiv=NULL, array $options=array ( ))
$content	string	meta标签的内容属性
$name	string	meta标签的属性名。如果是null，属性将不会被生成
$httpEquiv	string	meta标签的http-equiv属性。如果是null，属性将不会被生成
$options	array	其它选项的名称-值对(例如 'scheme'， 'lang')
{return}	string	生成的meta标签

生成一个meta标签，可以插入到HTML页面的头部部分。

public static string normalizeUrl(mixed $url)
$url	mixed	生成一个有效的URL的参数
{return}	string	有效的URL

通过标准的输入来生成一个有效的URL。

如果输入参数是一个空字符串，将返回当前请求的URL。

如果输入参数不是一个空字符串， 它被当作一个有效的URL，不作任何改变被返回。

如果输入参数是一个数组，它被视为一个控制器路由和一个GET参数列表， 将会调用CController::createUrl方法来创建一个URL。 既然这样，数组的第一个元素是指控制器的路由， 其它的键名-键值对指额外的URL参数。 例如，array('post/list', 'page'=>3) 可以生成一个URL /index.php?r=post/list&page=3.

public static string openTag(string $tag, array $htmlOptions=array ( ))
$tag	string	标签名
$htmlOptions	array	元素的属性。属性值将被encode()HTML编码。 如果给了一个'encode'属性，而且属性值为false的话， 其余的属性值将不会被HTML编码。 自1.1.5起，属性值为null的属性将不会被渲染。
{return}	string	生成的HTML元素标签

生成一个HTML元素的开始标签。

public static string pageStateField(string $value)
$value	string	序列化的持久状态
{return}	string	生成的隐藏域

生成一个用于存储页面持久状态的隐藏域。 这个方法在内部为statefulForm所用。

public static string passwordField(string $name, string $value='', array $htmlOptions=array ( ))
$name	string	输入框的名称
$value	string	输入框的值
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的密码输入框

生成一个密码输入框。

public static string radioButton(string $name, boolean $checked=false, array $htmlOptions=array ( ))
$name	string	按钮的名称
$checked	boolean	单选按钮是否被选中状态
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。) 自1.1.2版起，一个名称为‘uncheckValue’的特殊选项可以被使用， 这个特殊选项的值在当单选按钮没有被选中时返回。 如果设置了这个特殊选项值，那么一个隐藏域会被渲染，以便当单选按钮没有被选中时，我们仍然可以获得一个未选中时的值。 如果‘uncheckValue’没有被设置或设置为NULL，隐藏域将不会被渲染。
{return}	string	生成的单选按钮

生成一个单选按钮。

public static string radioButtonList(string $name, string $select, array $data, array $htmlOptions=array ( ))
$name	string	单选按钮列表的名称。 一旦表单被提交，你可以使用这个名称来获取被选中的值。
$select	string	被选中的单选按钮。
$data	array	用于生成单选按钮列表的值-标签对。 注意，值将自动被HTML编码，然而标签不会。
$htmlOptions	array	附加的HTML选项。 选项将会应用于每个单选按钮上，下面这些特定的选项是被认可的： template: 字符串，指定如何渲染每个复选框。 默认为"{input} {label}"， 其中"{input}"将被生成的单选按钮标签取代， 而"{label}"会替换为相应的复选框标签的label。 separator: 字符串，分隔生成的单选按钮的字符串。默认为一个新行（ ） labelOptions: 数组， 指定为列表中的每个标签渲染的附加的HTML属性。
{return}	string	生成的单选按钮列表

生成一个单选按钮列表。 一个单选按钮列表就像是一个复选框列表， 只是它是允许选中单个。.

public static void refresh(integer $seconds, string $url='')
$seconds	integer	刷新页面前等待的秒数
$url	string	要跳转的URL，如果是空，意味着当前页。

注册一个“刷新”meta标签。 这个方法可以在一个视图的任何地方被唤起。 它将用CClientScript来注册一个“刷新”meta标签， 可以让页面在特定的秒数后刷新。

public static string renderAttributes(array $htmlOptions)
$htmlOptions	array	将被渲染的属性
{return}	string	渲染结果

渲染HTML标签属性。 自1.1.5版起，属性值为null的属性将不会被渲染。 特殊的属性，像'checked', 'disabled', 'readonly'， 将被渲染为为它们相对应的布尔值。

public static string resetButton(string $label='reset', array $htmlOptions=array ( ))
$label	string	按钮的标签
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的按钮标签

生成一个重置按钮。

public static string resolveName(CModel $model, string &$attribute)
$model	CModel	数据模型
$attribute	string	属性
{return}	string	输入标签的名称

生成一个模型属性的输入名称 注意，调用此方法后，如果名称包含方括号前的真实属性的名称（主要用于表格输入）， 属性的名称可能会被修改。

public static void resolveNameID(CModel $model, string &$attribute, array &$htmlOptions)
$model	CModel	数据模型
$attribute	string	属性
$htmlOptions	array	HTML选项

生成一个模型属性的输入框名称和ID。 这个方法会根据设置的'name'和'id'属性来更新HTML的选项。 此方法也可以修改属性的名称， 如果名称中包含方括号的话（主要用于表格输入）。

public static mixed resolveValue(CModel $model, string $attribute)
$model	CModel	数据模型
$attribute	string	属性名
{return}	mixed	属性值

评估模型的属性值。 这个方法认可一个数组格式的属性名。 例如，如果属性名为'name[a][b]', 那么"$model->name['a']['b']"的值将被返回。

public static string script(string $text)
$text	string	将被密封的Javascript
{return}	string	密封好的Javascript

将给定的Javascript密封到一个script标签中。

public static string scriptFile(string $url)
$url	string	JavaScript文件的URL
{return}	string	JavaScript文件标签

包含一个Javascript文件。

public static string statefulForm(mixed $action='', string $method='post', array $htmlOptions=array ( ))
$action	mixed	表单的action链接(关于这个参数详见normalizeUrl。)
$method	string	表单方法(例如 post, get)
$htmlOptions	array	附加的HTML属性(请参阅tag)。
{return}	string	生成的表单标签。

生成一个有状态的表单标签。 一个有状态的表单标签类似于form，除这以外， 它还可以渲染一个附加的用于持久存储页面状态的隐藏域。 如果你想在表单提交的时候可以访问页面持久状态，那么你就可以用这个方法生成一个表单标签

public static string submitButton(string $label='submit', array $htmlOptions=array ( ))
$label	string	按钮的标签
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的按钮标签

生成一个提交按钮。

public static string tag(string $tag, array $htmlOptions=array ( ), mixed $content=false, boolean $closeTag=true)
$tag	string	标签名
$htmlOptions	array	元素的属性。属性值将被encode()HTML编码。 如果给了一个'encode'属性，而且属性值为false的话， 其余的属性值将不会被HTML编码。 自1.1.5起，属性值为null的属性将不会被渲染。
$content	mixed	被附加在开启和闭合的元素标记之间的内容。它不会被HTML编码。 如果是false，意味着没有主体内容。
$closeTag	boolean	是否生成结束标记。
{return}	string	生成的HTML元素标签

生成一个HTML元素。

public static string textArea(string $name, string $value='', array $htmlOptions=array ( ))
$name	string	文本框的名称
$value	string	文本框的值
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的文本框

生成一个文本框。

public static string textField(string $name, string $value='', array $htmlOptions=array ( ))
$name	string	输入框的名称
$value	string	输入框的值
$htmlOptions	array	附加的HTML属性。除了正常的HTML属性外， 一些特殊的属性也是可以的(请参阅clientChange和tag来了解更多详细信息。)
{return}	string	生成的文本输入框

生成一个文本输入框。

public static mixed value(mixed $model, string $attribute, mixed $defaultValue=NULL)
$model	mixed	模型。可以是一个对象也可以是一个数组。
$attribute	string	属性名(用点连接的多重属性)
$defaultValue	mixed	当属性不存在时返回的默认值
{return}	mixed	n属性值

评估给定的模型中指定属性的值。 属性名可以用点语法的形式给出。例如， 如果属性是"author.firstName"，这个方法将返回"$model->author->firstName"的值。 如果属性不存在或者在中间被打断， 将会返回一个默认值（被看作是最后一个参数）(例如$model->author是null). 模型可以是一个对象也可以是一个数组。 如果是数组，属性被看作是数组的一个键名。 例如"author.firstName"，意味着是数组值"$model['author']['firstName']"。