CHtml

属性详情

the HTML code to be appended to the required label.

the HTML code to be prepended to the required label.

the counter for generating automatic input field names.

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

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

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

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

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

方法详情

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.

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.

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.

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).

Generates a hidden input for a model attribute.

Generates input field ID for a model attribute.

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.

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 (see CModel::getAttributeLabel. If the attribute has input error, the label's CSS class will be appended with errorCss.

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.

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.

Generates input field name for a model attribute. Unlike resolveName, this method does NOT modify the attribute name.

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.

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.

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.

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.

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.

Appends errorCss to the 'class' attribute.

Generates the JavaScript that initiates an AJAX request.

Generates a push button that can initiate AJAX requests.

Generates a link that can initiate AJAX requests.

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

Generates the URL for the published assets.

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

Generates a button.

Encloses the given string within a CDATA tag.

Generates a check box.

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

Generates the JavaScript with the specified client changes.

Generates a close HTML element.

Encloses the given CSS content with a CSS tag.

Links to the specified CSS file.

Generates a drop down list.

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

Encodes special characters in an array of strings into HTML entities. Both the array keys and values will be encoded if needed. If a value is an array, this method will also encode it recursively. The application charset will be used for encoding.

Generates a closing form tag.

Displays the first validation error for a model attribute.

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

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).

Generates an opening form tag. This is a shortcut to beginForm.

Returns the element ID that is used by methods such as activeTextField. This method has been deprecated since version 1.0.5. Please use activeId instead.

Generates a valid HTML ID based the name.

Generates a hidden input.

Generates a button using HTML button tag. This method is similar to button except that it generates a 'button' tag instead of 'input' tag.

Generates an image tag.

Generates an image submit button.

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

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.

Generates a label tag.

Generates a hyperlink tag.

Generates a link submit button.

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.

Generates a list box.

Generates the data suitable for dropDownList and listBox. Note, this method does not HTML-encode the generated data. You may call encodeArray to encode it if needed. Please refer to the value method on how to specify value field, text field and group field.

Generates the list options.

Generates a mailto link.

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

Normalizes the input parameter to be a valid URL.

If the input parameter is an empty string, the currently requested URL will be returned.

If the input parameter is a non-empty string, it is treated as a valid URL and will be returned without any change.

If the input parameter is an array, it is treated as a controller route and a list of GET parameters, and the CController::createUrl method will be invoked to create a URL. In this case, the first array element refers to the controller route, and the rest key-value pairs refer to the additional GET parameters for the URL. For example, array('post/list', 'page'=>3) may be used to generate the URL /index.php?r=post/list&page=3.

Generates an open HTML element.

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

Generates a password field input.

Generates a radio button.

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

Renders the HTML tag attributes.

Generates a reset button.

Generates input name for a model attribute. Note, the attribute name may be modified after calling this method if the name contains square brackets (mainly used in tabular input).

Generates input name and ID for a model attribute. This method will update the HTML options by setting appropriate 'name' and 'id' attributes. This method may also modify the attribute name if the name contains square brackets (mainly used in tabular input).

Encloses the given JavaScript within a script tag.

Includes a JavaScript file.

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.

Generates a submit button.

Generates an HTML element.

Generates a text area input.

Generates a text field input.

Evaluates the value of the specified attribute for the given model. The attribute name can be given in a dot syntax. For example, if the attribute is "author.firstName", this method will return the value of "$model->author->firstName". A default value (passed as the last parameter) will be returned if the attribute does not exist or is broken in the middle (e.g. $model->author is null). The model can be either an object or an array. If the latter, the attribute is treated as a key of the array. For the example of "author.firstName", if would mean the array value "$model['author']['firstName']".