widgets\ActiveField checkbox()

checkbox() public method

Renders a checkbox.

This method will generate the checked tag attribute according to the model attribute value.

public $this checkbox ( $options = [], $enclosedByLabel = true )
$options array

The tag options in terms of name-value pairs. The following options are specially handled:

  • uncheck: string, the value associated with the uncheck state of the radio button. If not set, it will take the default value 0. This method will render a hidden input so that if the radio button is not checked and is submitted, the value of this attribute will still be submitted to the server via the hidden input. If you do not want any hidden input, you should explicitly set this option as null.
  • label: string, a label displayed next to the checkbox. It will NOT be HTML-encoded. Therefore you can pass in HTML code such as an image tag. If this is coming from end users, you should encode it to prevent XSS attacks. When this option is specified, the checkbox will be enclosed by a label tag. If you do not want any label, you should explicitly set this option as null.
  • labelOptions: array, the HTML attributes for the label tag. This is only used when the label option is specified.

The rest of the options will be rendered as the attributes of the resulting tag. The values will be HTML-encoded using yii\helpers\Html::encode(). If a value is null, the corresponding attribute will not be rendered.

If you set a custom id for the input element, you may need to adjust the $selectors accordingly.

$enclosedByLabel boolean

Whether to enclose the checkbox within the label. If true, the method will still use $template to layout the checkbox and the error message except that the checkbox is enclosed by the label tag.

return $this

The field object itself.

doc_Yii
2016-10-30 17:17:48
Comments
Leave a Comment

Please login to continue.