CHtml

Package system.web.helpers
Inheritance class CHtml
Since 1.0
Version $Id: CHtml.php 753 2009-02-26 17:21:54Z qiang.xue $
CHtml is a static class that provides a collection of helper methods for creating HTML views.

Public Properties

Hide inherited properties

PropertyTypeDescriptionDefined By
afterRequiredLabel string the HTML code to be appended to the required label. CHtml
beforeRequiredLabel string the HTML code to be prepended to the required label. CHtml
errorCss string the CSS class for highlighting error inputs. CHtml
errorMessageCss string the CSS class for displaying error messages (see error). CHtml
errorSummaryCss string the CSS class for displaying error summaries (see errorSummary). CHtml
requiredCss string the CSS class for required labels. CHtml
scenario string the scenario used to determine whether a model attribute is required. CHtml

Public Methods

Hide inherited methods

MethodDescriptionDefined By
activeCheckBox() Generates a check box for a model attribute. CHtml
activeCheckBoxList() Generates a check box list for a model attribute. CHtml
activeDropDownList() Generates a drop down list for a model attribute. CHtml
activeFileField() Generates a file input for a model attribute. CHtml
activeHiddenField() Generates a hidden input for a model attribute. CHtml
activeId() Generates input field ID for a model attribute. CHtml
activeLabel() Generates a label tag for a model attribute. CHtml
activeLabelEx() Generates a label tag for a model attribute. CHtml
activeListBox() Generates a list box for a model attribute. CHtml
activeName() Generates input field name for a model attribute. CHtml
activePasswordField() Generates a password field input for a model attribute. CHtml
activeRadioButton() Generates a radio button for a model attribute. CHtml
activeRadioButtonList() Generates a radio button list for a model attribute. CHtml
activeTextArea() Generates a text area input for a model attribute. CHtml
activeTextField() Generates a text field input for a model attribute. CHtml
ajax() Generates the JavaScript that initiates an AJAX request. CHtml
ajaxButton() Generates a push button that can initiate AJAX requests. CHtml
ajaxLink() Generates a link that can initiate AJAX requests. CHtml
ajaxSubmitButton() Generates a push button that can submit the current form in POST method. CHtml
asset() Generates the URL for the published assets. CHtml
button() Generates a button. CHtml
cdata() Encloses the given string within a CDATA tag. CHtml
checkBox() Generates a check box. CHtml
checkBoxList() Generates a check box list. CHtml
closeTag() Generates a close HTML element. CHtml
css() Encloses the given CSS content with a CSS tag. CHtml
cssFile() Links to the specified CSS file. CHtml
dropDownList() Generates a drop down list. CHtml
encode() Encodes special characters into HTML entities. CHtml
error() Displays the first validation error for a model attribute. CHtml
errorSummary() Displays a summary of validation errors for one or several models. CHtml
fileField() Generates a file input. CHtml
form() Generates a form tag. CHtml
getActiveId() Returns the element ID that is used by methods such as activeTextField. CHtml
getIdByName() Generates a valid HTML ID based the name. CHtml
hiddenField() Generates a hidden input. CHtml
image() Generates an image tag. CHtml
imageButton() Generates an image submit button. CHtml
label() Generates a label tag. CHtml
link() Generates a hyperlink tag. CHtml
linkButton() Generates a link submit button. CHtml
linkTag() Generates a link tag that can be inserted in the head section of HTML page. CHtml
listBox() Generates a list box. CHtml
listData() Generates the data suitable for dropDownList and listBox. CHtml
listOptions() Generates the list options. CHtml
mailto() Generates a mailto link. CHtml
metaTag() Generates a meta tag that can be inserted in the head section of HTML page. CHtml
normalizeUrl() Generates a URL if the input specifies the route to a controller action. CHtml
openTag() Generates an open HTML element. CHtml
pageStateField() Generates a hidden field for storing persistent page states. CHtml
passwordField() Generates a password field input. CHtml
radioButton() Generates a radio button. CHtml
radioButtonList() Generates a radio button list. CHtml
resetButton() Generates a reset button. CHtml
script() Encloses the given JavaScript within a script tag. CHtml
scriptFile() Includes a JavaScript file. CHtml
statefulForm() Generates a stateful form tag. CHtml
submitButton() Generates a submit button. CHtml
tag() Generates an HTML element. CHtml
textArea() Generates a text area input. CHtml
textField() Generates a text field input. CHtml

Protected Methods

Hide inherited methods

MethodDescriptionDefined By
activeInputField() Generates an input HTML tag for a model attribute. CHtml
addErrorCss() Appends errorCss to the 'class' attribute. CHtml
clientChange() Generates the JavaScript with the specified client changes. CHtml
inputField() Generates an input HTML tag. CHtml
resolveName() Generates input name for a model attribute. CHtml
resolveNameID() Generates input name and ID for a model attribute. CHtml

Property Details

afterRequiredLabel property
public static string $afterRequiredLabel;

the HTML code to be appended to the required label.

See Also

beforeRequiredLabel property
public static string $beforeRequiredLabel;

the HTML code to be prepended to the required label.

See Also

errorCss property
public static string $errorCss;

the CSS class for highlighting error inputs. Form inputs will be appended with this CSS class if they have input errors.

errorMessageCss property
public static string $errorMessageCss;

the CSS class for displaying error messages (see error).

errorSummaryCss property
public static string $errorSummaryCss;

the CSS class for displaying error summaries (see errorSummary).

requiredCss property
public static string $requiredCss;

the CSS class for required labels. Defaults to 'required'.

See Also

scenario property
public static string $scenario;

the scenario used to determine whether a model attribute is required.

See Also

Method Details

activeCheckBox() method
public static string activeCheckBox(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.) Since version 1.0.2, a special option named 'uncheckValue' is available that can be used to specify the value returned when the checkbox is not checked. By default, this value is '0'.
{return} string the generated check box

Generates a check box for a model attribute. The attribute is assumed to take either true or false value. If the attribute has input error, the input field's CSS class will be appended with errorCss.

See Also

activeCheckBoxList() method
public static string activeCheckBoxList(CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$data array value-label pairs used to generate the check box list.
$htmlOptions array addtional HTML options. The options will be applied to each checkbox input. The following special options are recognized:
  • template: string, specifies how each checkbox is rendered. Defaults to "{input} {label}", where "{input}" will be replaced by the generated check box input tag while "{label}" be replaced by the corresponding check box label.
  • separator: string, specifies the string that separates the generated check boxes.
{return} string the generated check box list

Generates a check box list for a model attribute. The model attribute value is used as the selection. If the attribute has input error, the input field's CSS class will be appended with errorCss. Note that a check box list allows multiple selection, like listBox. As a result, the corresponding POST value is an array. In case no selection is made, the corresponding POST value is an empty string.

See Also

activeDropDownList() method
public static string activeDropDownList(CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$data array data for generating the list options (value=>display) You may use listData to generate this data. Please refer to listOptions on how this data is used to generate the list options.
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated drop down list

Generates a drop down list for a model attribute. If the attribute has input error, the input field's CSS class will be appended with errorCss.

See Also

activeFileField() method
public static string activeFileField(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes.
{return} string the generated input field

Generates a file input for a model attribute. Note, you have to set the enclosing form's 'enctype' attribute to be 'multipart/form-data'. After the form is submitted, the uploaded file information can be obtained via $_FILES (see PHP documentation).

See Also

activeHiddenField() method
public static string activeHiddenField(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes.
{return} string the generated input field

Generates a hidden input for a model attribute.

See Also

activeId() method (available since v1.0.1)
public static string activeId(CModel $model, string $attribute)
$model CModel the data model
$attribute string the attribute
{return} string the generated input field ID

Generates input field ID for a model attribute.

activeInputField() method
protected static string activeInputField(string $type, CModel $model, string $attribute, array $htmlOptions)
$type string the input type (e.g. 'text', 'radio')
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes for the HTML tag
{return} string the generated input tag

Generates an input HTML tag for a model attribute. This method generates an input HTML tag based on the given data model and attribute. If the attribute has input error, the input field's CSS class will be appended with errorCss. This enables highlighting the incorrect input.

activeLabel() method
public static string activeLabel(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes.
{return} string the generated label tag

Generates a label tag for a model attribute. The label text is the attribute label and the label is associated with the input for the attribute. If the attribute has input error, the label's CSS class will be appended with errorCss.

activeLabelEx() method (available since v1.0.2)
public static string activeLabelEx(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes.
{return} string the generated label tag

Generates a label tag for a model attribute. This is an enhanced version of activeLabel. It will render additional CSS class and mark when the attribute is required. In particular, it calls CModel::isAttributeRequired to determine if the attribute is required under the scenario CHtml::scenario. If so, it will add a CSS class CHtml::requiredCss to the label, and decorate the label with CHtml::beforeRequiredLabel and CHtml::afterRequiredLabel.

activeListBox() method
public static string activeListBox(CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$data array data for generating the list options (value=>display) You may use listData to generate this data. Please refer to listOptions on how this data is used to generate the list options.
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated list box

Generates a list box for a model attribute. The model attribute value is used as the selection. If the attribute has input error, the input field's CSS class will be appended with errorCss.

See Also

activeName() method (available since v1.0.1)
public static string activeName(CModel $model, string $attribute)
$model CModel the data model
$attribute string the attribute
{return} string the generated input field name

Generates input field name for a model attribute.

activePasswordField() method
public static string activePasswordField(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated input field

Generates a password field input for a model attribute. If the attribute has input error, the input field's CSS class will be appended with errorCss.

See Also

activeRadioButton() method
public static string activeRadioButton(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated radio button

Generates a radio button for a model attribute. If the attribute has input error, the input field's CSS class will be appended with errorCss.

See Also

activeRadioButtonList() method
public static string activeRadioButtonList(CModel $model, string $attribute, array $data, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$data array value-label pairs used to generate the radio button list.
$htmlOptions array addtional HTML options. The options will be applied to each checkbox input. The following special options are recognized:
  • template: string, specifies how each checkbox is rendered. Defaults to "{input} {label}", where "{input}" will be replaced by the generated radio button input tag while "{label}" be replaced by the corresponding radio button label.
  • separator: string, specifies the string that separates the generated radio buttons.
{return} string the generated radio button list

Generates a radio button list for a model attribute. The model attribute value is used as the selection. If the attribute has input error, the input field's CSS class will be appended with errorCss.

See Also

activeTextArea() method
public static string activeTextArea(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated text area

Generates a text area input for a model attribute. If the attribute has input error, the input field's CSS class will be appended with errorCss.

See Also

activeTextField() method
public static string activeTextField(CModel $model, string $attribute, array $htmlOptions=array ( ))
$model CModel the data model
$attribute string the attribute
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated input field

Generates a text field input for a model attribute. If the attribute has input error, the input field's CSS class will be appended with errorCss.

See Also

addErrorCss() method
protected static void addErrorCss(array $htmlOptions)
$htmlOptions array HTML options to be modified

Appends errorCss to the 'class' attribute.

ajax() method
public static string ajax(array $options)
$options array AJAX options. The valid options are specified in the jQuery ajax documentation. The following special options are added for convenience:
  • update: string, specifies the selector whose HTML content should be replaced by the AJAX request result.
  • replace: string, specifies the selector whose target should be replaced by the AJAX request result.
Note, if you specify the 'success' option, the above options will be ignored.
{return} string the generated JavaScript

Generates the JavaScript that initiates an AJAX request.

See Also

ajaxButton() method
public static string ajaxButton(string $label, string $url, array $ajaxOptions=array ( ), array $htmlOptions=array ( ))
$label string the button label
$url string the URL for the AJAX request. If empty, it is assumed to be the current URL. See normalizeUrl for more details.
$ajaxOptions array AJAX options (see ajax)
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated button

Generates a push button that can initiate AJAX requests.

ajaxLink() method
public static string ajaxLink(string $text, string $url, array $ajaxOptions=array ( ), array $htmlOptions=array ( ))
$text string the link body (it will NOT be HTML-encoded.)
$url string the URL for the AJAX request. If empty, it is assumed to be the current URL. See normalizeUrl for more details.
$ajaxOptions array AJAX options (see ajax)
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated link

Generates a link that can initiate AJAX requests.

See Also

ajaxSubmitButton() method
public static string ajaxSubmitButton(string $label, string $url, array $ajaxOptions=array ( ), array $htmlOptions=array ( ))
$label string the button label
$url string the URL for the AJAX request. If empty, it is assumed to be the current URL. See normalizeUrl for more details.
$ajaxOptions array AJAX options (see ajax)
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated button

Generates a push button that can submit the current form in POST method.

asset() method
public static string asset(string $path, boolean $hashByName=false)
$path string the path of the asset to be published
$hashByName boolean whether the published directory should be named as the hashed basename. If false, the name will be the hashed dirname of the path being published. Defaults to false. Set true if the path being published is shared among different extensions.
{return} string the asset URL

Generates the URL for the published assets.

button() method
public static string button(string $label='button', array $htmlOptions=array ( ))
$label string the button label
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated button tag

Generates a button.

See Also

cdata() method
public static string cdata(string $text)
$text string the string to be enclosed
{return} string the CDATA tag with the enclosed content.

Encloses the given string within a CDATA tag.

checkBox() method
public static string checkBox(string $name, boolean $checked=false, array $htmlOptions=array ( ))
$name string the input name
$checked boolean whether the check box is checked
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated check box

Generates a check box.

See Also

checkBoxList() method
public static string checkBoxList(string $name, mixed $select, array $data, array $htmlOptions=array ( ))
$name string name of the check box list. You can use this name to retrieve the selected value(s) once the form is submitted.
$select mixed selection of the check boxes. This can be either a string for single selection or an array for multiple selections.
$data array value-label pairs used to generate the check box list.
$htmlOptions array addtional HTML options. The options will be applied to each checkbox input. The following special options are recognized:
  • template: string, specifies how each checkbox is rendered. Defaults to "{input} {label}", where "{input}" will be replaced by the generated check box input tag while "{label}" be replaced by the corresponding check box label.
  • separator: string, specifies the string that separates the generated check boxes.
{return} string the generated check box list

Generates a check box list. A check box list allows multiple selection, like listBox. As a result, the corresponding POST value is an array.

clientChange() method
protected static void clientChange(string $event, array $htmlOptions)
$event string event name (without 'on')
$htmlOptions array HTML attributes which may contain the following special attributes specifying the client change behaviors:
  • submit: string, specifies the URL that the button should submit to. If empty, the current requested URL will be used.
  • params: array, name-value pairs that should be submitted together with the form. This is only used when 'submit' option is specified.
  • return: boolean, the return value of the javascript. Defaults to false, meaning that the execution of javascript would not cause the default behavior of the event. This option has been available since version 1.0.2.
  • confirm: string, specifies the message that should show in a pop-up confirmation dialog.
  • ajax: array, specifies the AJAX options (see ajax).

Generates the JavaScript with the specified client changes.

closeTag() method
public static string closeTag(string $tag)
$tag string the tag name
{return} string the generated HTML element tag

Generates a close HTML element.

css() method
public static string css(string $text, string $media='')
$text string the CSS content
$media string the media that this CSS should apply to.
{return} string the CSS properly enclosed

Encloses the given CSS content with a CSS tag.

cssFile() method
public static string cssFile(string $url, string $media='')
$url string the CSS URL
$media string the media that this CSS should apply to.
{return} string the CSS link.

Links to the specified CSS file.

dropDownList() method
public static string dropDownList(string $name, string $select, array $data, array $htmlOptions=array ( ))
$name string the input name
$select string the selected value
$data array data for generating the list options (value=>display). You may use listData to generate this data. Please refer to listOptions on how this data is used to generate the list options.
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated drop down list

Generates a drop down list.

See Also

encode() method
public static string encode(string $text)
$text string data to be encoded
{return} string the encoded data

Encodes special characters into HTML entities. The application charset will be used for encoding.

See Also

error() method
public static string error(CModel $model, string $attribute)
$model CModel the data model
$attribute string the attribute name
{return} string the error display. Empty if no errors are found.

Displays the first validation error for a model attribute.

See Also

errorSummary() method
public static string errorSummary(mixed $model, string $header=NULL, string $footer=NULL)
$model mixed the models whose input errors are to be displayed. This can be either a single model or an array of models.
$header string a piece of HTML code that appears in front of the errors
$footer string a piece of HTML code that appears at the end of the errors
{return} string the error summary. Empty if no errors are found.

Displays a summary of validation errors for one or several models.

See Also

fileField() method
public static string fileField(string $name, string $value='', array $htmlOptions=array ( ))
$name string the input name
$value string the input value
$htmlOptions array additional HTML attributes.
{return} string the generated input field

Generates a file input. Note, you have to set the enclosing form's 'enctype' attribute to be 'multipart/form-data'. After the form is submitted, the uploaded file information can be obtained via $_FILES[$name] (see PHP documentation).

See Also

form() method
public static string form(mixed $action='', string $method='post', array $htmlOptions=array ( ))
$action mixed the form action URL (see normalizeUrl for details about this parameter.)
$method string form method (e.g. post, get)
$htmlOptions array additional HTML attributes.
{return} string the generated form tag.

Generates a form tag. Note, only the open tag is generated. A close tag should be placed manually at the end of the form.

getActiveId() method
public static string getActiveId(CModel $model, string $attribute)
$model CModel the data model
$attribute string the attribute
{return} string the element ID for the active field corresponding to the specified model and attribute.

Returns the element ID that is used by methods such as activeTextField.

getIdByName() method
public static string getIdByName($name)
$name
{return} string the ID generated based on name.

Generates a valid HTML ID based the name.

hiddenField() method
public static string hiddenField(string $name, string $value='', array $htmlOptions=array ( ))
$name string the input name
$value string the input value
$htmlOptions array additional HTML attributes.
{return} string the generated input field

Generates a hidden input.

See Also

image() method
public static string image(string $src, string $alt='', array $htmlOptions=array ( ))
$src string the image URL
$alt string the alternative text display
$htmlOptions array additional HTML attributes.
{return} string the generated image tag

Generates an image tag.

imageButton() method
public static string imageButton(string $src, array $htmlOptions=array ( ))
$src string the button label
$htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
{return} string the generated button tag

Generates an image submit button.

See Also

inputField() method
protected static string inputField(string $type, string $name, string $value, array $htmlOptions)
$type string the input type (e.g. 'text', 'radio')
$name string the input name
$value string the input value
$htmlOptions array additional HTML attributes for the HTML tag
{return} string the generated input tag

Generates an input HTML tag. This method generates an input HTML tag based on the given input name and value.

label() method
public static string label(string $label, string $for, array $htmlOptions=array ( ))
$label string label text. Note, you should HTML-encode the text if needed.
$for string the ID of the HTML element that this label is associated with
$htmlOptions array additional HTML attributes. Starting from version 1.0.2, the following HTML option is recognized: 
  • required: if this is set and is true, the label will be styled
with CSS class 'required' (customizable with CHtml::$requiredCss),
and be decorated with CHtml::beforeRequiredLabel and
CHtml::afterRequiredLabel.
    •
    {return} string the generated label tag

    Generates a label tag.

    link() method
    public static string link(string $text, mixed $url='#', array $htmlOptions=array ( ))
    $text string link body. It will NOT be HTML-encoded. Therefore you can pass in HTML code such as an image tag.
    $url mixed a URL or an action route that can be used to create a URL. See normalizeUrl for more details about how to specify this parameter.
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated hyperlink

    Generates a hyperlink tag.

    See Also

    linkButton() method
    public static string linkButton(string $label='submit', array $htmlOptions=array ( ))
    $label string the button label
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated button tag

    Generates a link submit button.

    See Also

    linkTag() method (available since v1.0.1)
    public static string linkTag(string $relation=NULL, string $type=NULL, string $href=NULL, string $media=NULL, array $options=array ( ))
    $relation string rel attribute of the link tag. If null, the attribute will not be generated.
    $type string type attribute of the link tag. If null, the attribute will not be generated.
    $href string href attribute of the link tag. If null, the attribute will not be generated.
    $media string media attribute of the link tag. If null, the attribute will not be generated.
    $options array other options in name-value pairs
    {return} string the generated link tag

    Generates a link tag that can be inserted in the head section of HTML page. Do not confuse this method with link(). The latter generates a hyperlink.

    listBox() method
    public static string listBox(string $name, string $select, array $data, array $htmlOptions=array ( ))
    $name string the input name
    $select string the selected value
    $data array data for generating the list options (value=>display) You may use listData to generate this data. Please refer to listOptions on how this data is used to generate the list options.
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated list box

    Generates a list box.

    See Also

    listData() method
    public static array listData(array $models, string $valueField, string $textField, string $groupField='')
    $models array a list of model objects. Starting from version 1.0.3, this parameter can also be an array of associative arrays (e.g. results of CDbCommand::queryAll).
    $valueField string the attribute name for list option values
    $textField string the attribute name for list option texts
    $groupField string the attribute name for list option group names. If empty, no group will be generated.
    {return} array the list data that can be used in dropDownList and listBox

    Generates the data suitable for dropDownList and listBox.

    listOptions() method
    public static string listOptions(mixed $selection, array $listData, array $htmlOptions)
    $selection mixed the selected value(s). This can be either a string for single selection or an array for multiple selections.
    $listData array the option data (see listData)
    $htmlOptions array additional HTML attributes. The following two special attributes are recognized:
    • prompt: string, specifies the prompt text shown as the first list option. Its value is empty.
    • empty: string, specifies the text corresponding to empty selection. Its value is empty.
    • options: array, specifies additional attributes for each OPTION tag. The array keys must be the option values, and the array values are the extra OPTION tag attributes in the name-value pairs. For example, 
          array(
        'value1'=>array('disabled'=>true, 'label'=>'value 1'),
        'value2'=>array('label'=>'value 2'),
    );
      This option has been available since version 1.0.3.
    {return} string the generated list options

    Generates the list options.

    mailto() method (available since v1.0.1)
    public static string mailto(string $text, string $email='', array $htmlOptions=array ( ))
    $text string link body. It will NOT be HTML-encoded. Therefore you can pass in HTML code such as an image tag.
    $email string email address. If this is empty, the first parameter (link body) will be treated as the email address.
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated mailto link

    Generates a mailto link.

    See Also

    metaTag() method (available since v1.0.1)
    public static string metaTag(string $content, string $name=NULL, string $httpEquiv=NULL, array $options=array ( ))
    $content string content attribute of the meta tag
    $name string name attribute of the meta tag. If null, the attribute will not be generated
    $httpEquiv string http-equiv attribute of the meta tag. If null, the attribute will not be generated
    $options array other options in name-value pairs (e.g. 'scheme', 'lang')
    {return} string the generated meta tag

    Generates a meta tag that can be inserted in the head section of HTML page.

    normalizeUrl() method
    public static void normalizeUrl(mixed $url)
    $url mixed the URL to be normalized. If a string, the URL is returned back; if an array, it is considered as a route to a controller action and will be used to generate a URL using CController::createUrl; if the URL is empty, the currently requested URL is returned.

    Generates a URL if the input specifies the route to a controller action.

    openTag() method
    public static string openTag(string $tag, array $htmlOptions=array ( ))
    $tag string the tag name
    $htmlOptions array the element attributes. The values will be HTML-encoded using encode().
    {return} string the generated HTML element tag

    Generates an open HTML element.

    pageStateField() method
    public static string pageStateField(string $value)
    $value string the persistent page states in serialized format
    {return} string the generated hidden field

    Generates a hidden field for storing persistent page states. This method is internally used by statefulForm.

    passwordField() method
    public static string passwordField(string $name, string $value='', array $htmlOptions=array ( ))
    $name string the input name
    $value string the input value
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated input field

    Generates a password field input.

    See Also

    radioButton() method
    public static string radioButton(string $name, boolean $checked=false, array $htmlOptions=array ( ))
    $name string the input name
    $checked boolean whether the check box is checked
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated radio button

    Generates a radio button.

    See Also

    radioButtonList() method
    public static string radioButtonList(string $name, mixed $select, array $data, array $htmlOptions=array ( ))
    $name string name of the radio button list. You can use this name to retrieve the selected value(s) once the form is submitted.
    $select mixed selection of the radio buttons. This can be either a string for single selection or an array for multiple selections.
    $data array value-label pairs used to generate the radio button list.
    $htmlOptions array addtional HTML options. The options will be applied to each checkbox input. The following special options are recognized:
    • template: string, specifies how each checkbox is rendered. Defaults to "{input} {label}", where "{input}" will be replaced by the generated radio button input tag while "{label}" be replaced by the corresponding radio button label.
    • separator: string, specifies the string that separates the generated radio buttons.
    {return} string the generated radio button list

    Generates a radio button list. A radio button list is like a check box list, except that it only allows single selection.

    resetButton() method
    public static string resetButton(string $label='reset', array $htmlOptions=array ( ))
    $label string the button label
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated button tag

    Generates a reset button.

    See Also

    resolveName() method (available since v1.0.2)
    protected static string resolveName(CModel $model, string $attribute)
    $model CModel the data model
    $attribute string the attribute
    {return} string the input name

    Generates input name for a model attribute.

    resolveNameID() method
    protected static void resolveNameID(CModel $model, string $attribute, array $htmlOptions)
    $model CModel the data model
    $attribute string the attribute
    $htmlOptions array the HTML options

    Generates input name and ID for a model attribute. This method will update the HTML options by setting appropriate 'name' and 'id' attributes.

    script() method
    public static string script(string $text)
    $text string the JavaScript to be enclosed
    {return} string the enclosed JavaScript

    Encloses the given JavaScript within a script tag.

    scriptFile() method
    public static string scriptFile(string $url)
    $url string URL for the JavaScript file
    {return} string the JavaScript file tag

    Includes a JavaScript file.

    statefulForm() method
    public static string statefulForm(mixed $action='', string $method='post', array $htmlOptions=array ( ))
    $action mixed the form action URL (see normalizeUrl for details about this parameter.)
    $method string form method (e.g. post, get)
    $htmlOptions array additional HTML attributes.
    {return} string the generated form tag.

    Generates a stateful form tag. A stateful form tag is similar to form except that it renders an additional hidden field for storing persistent page states. You should use this method to generate a form tag if you want to access persistent page states when the form is submitted.

    submitButton() method
    public static string submitButton(string $label='submit', array $htmlOptions=array ( ))
    $label string the button label
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated button tag

    Generates a submit button.

    See Also

    tag() method
    public static string tag(string $tag, array $htmlOptions=array ( ), mixed $content=false, boolean $closeTag=true)
    $tag string the tag name
    $htmlOptions array the element attributes. The values will be HTML-encoded using encode().
    $content mixed the content to be enclosed between open and close element tags. It will not be HTML-encoded. If false, it means there is no body content.
    $closeTag boolean whether to generate the close tag.
    {return} string the generated HTML element tag

    Generates an HTML element.

    textArea() method
    public static string textArea(string $name, string $value='', array $htmlOptions=array ( ))
    $name string the input name
    $value string the input value
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated text area

    Generates a text area input.

    See Also

    textField() method
    public static string textField(string $name, string $value='', array $htmlOptions=array ( ))
    $name string the input name
    $value string the input value
    $htmlOptions array additional HTML attributes. Besides normal HTML attributes, a few special attributes are also recognized (see clientChange for more details.)
    {return} string the generated input field

    Generates a text field input.

    See Also