CButtonColumn

Property Details

the configuration for additional buttons. Each array element specifies a single button which has the following format:

'buttonID' => array(
    'label'=>'...',     // text label of the button
    'url'=>'...',       // a PHP expression for generating the URL of the button
    'imageUrl'=>'...',  // image URL of the button. If not set or false, a text link is used
    'options'=>array(...), // HTML options for the button tag
    'click'=>'...',     // a JS function to be invoked when the button is clicked
    'visible'=>'...',   // a PHP expression for determining whether the button is visible
)

the image URL for the delete button. If not set, an integrated image will be used. You may set this property to be false to render a text link instead.

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

the HTML options for the view button tag.

a PHP expression that is evaluated for every delete button and whose result is used as the URL for the delete button. In this expression, the variable $row the row number (zero-based); $data the data model for the row; and $this the column object.

the confirmation message to be displayed when delete button is clicked. By setting this property to be false, no confirmation message will be displayed.

the template that is used to render the content in each data cell. These default tokens are recognized: {view}, {update} and {delete}. If the buttons property defines additional buttons, their IDs are also recognized here. For example, if a button named 'preview' is declared in buttons, we can use the token '{preview}' here to specify where to display the button.

the image URL for the update button. If not set, an integrated image will be used. You may set this property to be false to render a text link instead.

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

the HTML options for the update button tag.

a PHP expression that is evaluated for every update button and whose result is used as the URL for the update button. In this expression, the variable $row the row number (zero-based); $data the data model for the row; and $this the column object.

the image URL for the view button. If not set, an integrated image will be used. You may set this property to be false to render a text link instead.

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

the HTML options for the view button tag.

a PHP expression that is evaluated for every view button and whose result is used as the URL for the view button. In this expression, the variable $row the row number (zero-based); $data the data model for the row; and $this the column object.

Method Details

Initializes the column. This method registers necessary client script for the button column.

Initializes the default buttons (view, update and delete).

Registers the client scripts for the button column.

Renders a link button.

Renders the data cell content. This method renders the view, update and delete buttons in the data cell.

Total 5 comments:

<?php
$this->widget('zii.widgets.grid.CGridView', array(
  'dataProvider'=>$dataProvider,
  'columns'=>array(
    'attribute1_name',
    'attribute2_name',
    array(
      'class'=>'CButtonColumn',
      'viewButtonUrl'=>'Yii::app()->createUrl("/controllername/view", array("id" => $data->model_id))',
      'deleteButtonUrl'=>'Yii::app()->createUrl("/controllername/delete", array("id" => $data->model_id))',
      'updateButtonUrl'=>'Yii::app()->createUrl("/controllername/update", array("id" => $data->model_id))',
    ),
  ),
));
?>

<?php
$this->widget('zii.widgets.grid.CGridView', array(
    'dataProvider'=>$dataProvider,
    'columns'=>array(
        'firstName',
        'middleInitial',
        'lastName',
        array(
            'class'=>'CButtonColumn',
                        'template' => '{postview} {preview}',
                        'buttons' => array(
                            'postview' => array(
                    'label'=>'...',     // text label of the button
                    'url'=>'...',       // the PHP expression for generating the URL of the button
                    'imageUrl'=>'...',  // image URL of the button. If not set or false, a text link is used
                    'options'=>array(...), // HTML options for the button tag
                    'click'=>'...',     // a JS function to be invoked when the button is clicked
                            ),
                            'preview' => array(
                    'label'=>'...',     // text label of the button
                    'url'=>'...',       // the PHP expression for generating the URL of the button
                    'imageUrl'=>'...',  // image URL of the button. If not set or false, a text link is used
                    'options'=>array(...), // HTML options for the button tag
                    'click'=>'...',     // a JS function to be invoked when the button is clicked
                            ),
                            
                        ),
                        
        ),
    ),
)); ?>

Your Comment: