PHP Class TbToggleColumn

Renders a button to toggle values of a column Modified version of jToggle column of Nikola Trifunović

Inheritance: extends TbDataColumn

Mostra file Open project: yinhe/yincart Class Usage Examples

Public Properties

Property	Type	Description
$afterToggle		a javascript function that will be invoked after the toggle ajax call. The function signature is `function(data)` `success` status of the ajax call, true if the ajax call was successful, false if the ajax call failed. `data` the data returned by the server in case of a successful call or XHR object in case of error. Note that if success is true it does not mean that the delete was successful, it only means that the ajax call was successful. Example: array( class'=>'TbToggleColumn', 'afterToggle'=>'function(success,data){ if (success) alert("Toggled successfuly"); }', ),
$checkedButtonLabel		the label for the toggle button. Defaults to "Check". Note that the label will not be HTML-encoded when rendering.
$checkedIcon		the glyph icon toggle button "checked" state. You may set this property to be false to render a text link instead.
$displayText		display button with text or only icon with label tooltip
$emptyButtonLabel		the label for the NULL value toggle button. Defaults to "Not Set". Note that the label will not be HTML-encoded when rendering.
$emptyIcon		the glyph icon toggle button "empty" state (example for null value)
$filter		the HTML code representing a filter input (eg a text field, a dropdown list) that is used for this data column. This property is effective only when {@link CGridView::filter} is set. If this property is not set, a text field will be generated as the filter input; If this property is an array, a dropdown list will be generated that uses this property value as the list options. If you don't want a filter for this data column, set this value to false.
$footerHtmlOptions		the HTML options for the footer cell tag.
$headerHtmlOptions		the HTML options for the header cell tag.
$htmlOptions		the HTML options for the data cell tags.
$name		the attribute name of the data model. Used for column sorting, filtering and to render the corresponding attribute value in each data cell. If {@link value} is specified it will be used to rendered the data cell instead of the attribute value.
$sortable		whether the column is sortable. If so, the header cell will contain a link that may trigger the sorting. Defaults to true. Note that if {@link name} is not set, or if {@link name} is not allowed by {@link CSort}, this property will be treated as false.
$toggleAction		Name of the action to call and toggle values
$uncheckedButtonLabel		the label for the toggle button. Defaults to "Uncheck". Note that the label will not be HTML-encoded when rendering.
$uncheckedIcon		the glyph icon toggle button "unchecked" state. You may set this property to be false to render a text link instead.
$uniqueClassSuffix		suffix substituted to a name class of the tag
$value

Protected Properties

Property	Type	Description
$button		the configuration for toggle button.

Public Methods

Method	Description
init ( )	Initializes the column.

Protected Methods

Method	Description
initButton ( )	Initializes the default buttons (toggle).
registerClientScript ( )	Registers the client scripts for the button column.
renderDataCellContent ( integer $row, mixed $data )	Renders the data cell content.

Private Methods

Method	Description
getButtonLabel ( $value )

Method Details

init() public method

This method registers necessary client script for the button column.

public init ( )

initButton() protected method

Initializes the default buttons (toggle).

protected initButton ( )

registerClientScript() protected method

Registers the client scripts for the button column.

protected registerClientScript ( )

renderDataCellContent() protected method

This method renders the view, update and toggle buttons in the data cell.

protected renderDataCellContent ( integer $row, mixed $data )
$row	integer	the row number (zero-based)
$data	mixed	the data associated with the row

Property Details

$afterToggle public_oe property

a javascript function that will be invoked after the toggle ajax call. The function signature is function(data)

success status of the ajax call, true if the ajax call was successful, false if the ajax call failed.
data the data returned by the server in case of a successful call or XHR object in case of error.

Note that if success is true it does not mean that the delete was successful, it only means that the ajax call was successful. Example:

 array(
    class'=>'TbToggleColumn',
    'afterToggle'=>'function(success,data){ if (success) alert("Toggled successfuly"); }',
 ),

public $afterToggle

$button protected_oe property

the configuration for toggle button.

protected $button

$checkedButtonLabel public_oe property

the label for the toggle button. Defaults to "Check". Note that the label will not be HTML-encoded when rendering.

public $checkedButtonLabel

$checkedIcon public_oe property

the glyph icon toggle button "checked" state. You may set this property to be false to render a text link instead.

public $checkedIcon

$displayText public_oe property

display button with text or only icon with label tooltip

public $displayText

$emptyButtonLabel public_oe property

the label for the NULL value toggle button. Defaults to "Not Set". Note that the label will not be HTML-encoded when rendering.

public $emptyButtonLabel

$emptyIcon public_oe property

the glyph icon toggle button "empty" state (example for null value)

public $emptyIcon

$filter public_oe property

the HTML code representing a filter input (eg a text field, a dropdown list) that is used for this data column. This property is effective only when {@link CGridView::filter} is set. If this property is not set, a text field will be generated as the filter input; If this property is an array, a dropdown list will be generated that uses this property value as the list options. If you don't want a filter for this data column, set this value to false.

Since: 1.1.1

public $filter

$footerHtmlOptions public_oe property

the HTML options for the footer cell tag.

public $footerHtmlOptions

$headerHtmlOptions public_oe property

the HTML options for the header cell tag.

public $headerHtmlOptions

$htmlOptions public_oe property

the HTML options for the data cell tags.

public $htmlOptions

$name public_oe property

the attribute name of the data model. Used for column sorting, filtering and to render the corresponding attribute value in each data cell. If {@link value} is specified it will be used to rendered the data cell instead of the attribute value.

$sortable public_oe property

whether the column is sortable. If so, the header cell will contain a link that may trigger the sorting. Defaults to true. Note that if {@link name} is not set, or if {@link name} is not allowed by {@link CSort}, this property will be treated as false.

$toggleAction public_oe property

Name of the action to call and toggle values

public $toggleAction

$uncheckedButtonLabel public_oe property

the label for the toggle button. Defaults to "Uncheck". Note that the label will not be HTML-encoded when rendering.

public $uncheckedButtonLabel

$uncheckedIcon public_oe property

the glyph icon toggle button "unchecked" state. You may set this property to be false to render a text link instead.

public $uncheckedIcon

$uniqueClassSuffix public_oe property

suffix substituted to a name class of the tag

public $uniqueClassSuffix

$value public_oe property

public $value