ActionColumn.php 4.62 KB
Newer Older
Qiang Xue committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14
<?php
/**
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

namespace yii\grid;

use Yii;
use Closure;
use yii\helpers\Html;

/**
15 16
 * ActionColumn is a column for the [[GridView]] widget that displays buttons for viewing and manipulating the items.
 *
17 18 19 20 21 22 23 24 25 26 27 28
 * To add an ActionColumn to the gridview, add it to the [[GridView::columns|columns]] configuration as follows:
 *
 * ```php
 * 'columns' => [
 *     // ...
 *     [
 *         'class' => 'yii\grid\ActionColumn',
 *         // you may configure additional properties here
 *     ],
 * ]
 * ```
 *
Qiang Xue committed
29 30 31 32 33
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @since 2.0
 */
class ActionColumn extends Column
{
34 35 36 37 38 39 40
	/**
	 * @var string the ID of the controller that should handle the actions specified here.
	 * If not set, it will use the currently active controller. This property is mainly used by
	 * [[urlCreator]] to create URLs for different actions. The value of this property will be prefixed
	 * to each action name to form the route of the action.
	 */
	public $controller;
41 42 43 44 45 46 47 48
	/**
	 * @var string the template used for composing each cell in the action column.
	 * Tokens enclosed within curly brackets are treated as controller action IDs (also called *button names*
	 * in the context of action column). They will be replaced by the corresponding button rendering callbacks
	 * specified in [[buttons]]. For example, the token `{view}` will be replaced by the result of
	 * the callback `buttons['view']`. If a callback cannot be found, the token will be replaced with an empty string.
	 * @see buttons
	 */
Qiang Xue committed
49
	public $template = '{view} {update} {delete}';
50 51 52 53 54 55 56 57 58 59 60 61 62 63
	/**
	 * @var array button rendering callbacks. The array keys are the button names (without curly brackets),
	 * and the values are the corresponding button rendering callbacks. The callbacks should use the following
	 * signature:
	 *
	 * ```php
	 * function ($url, $model) {
	 *     // return the button HTML code
	 * }
	 * ```
	 *
	 * where `$url` is the URL that the column creates for the button, and `$model` is the model object
	 * being rendered for the current row.
	 */
Alexander Makarov committed
64
	public $buttons = [];
65 66 67 68 69
	/**
	 * @var callback a callback that creates a button URL using the specified model information.
	 * The signature of the callback should be the same as that of [[createUrl()]].
	 * If this property is not set, button URLs will be created using [[createUrl()]].
	 */
Qiang Xue committed
70 71
	public $urlCreator;

72 73 74 75

	/**
	 * @inheritdoc
	 */
Qiang Xue committed
76 77 78 79 80 81
	public function init()
	{
		parent::init();
		$this->initDefaultButtons();
	}

82 83 84
	/**
	 * Initializes the default button rendering callbacks
	 */
Qiang Xue committed
85 86 87
	protected function initDefaultButtons()
	{
		if (!isset($this->buttons['view'])) {
88
			$this->buttons['view'] = function ($url, $model) {
Alexander Makarov committed
89
				return Html::a('<span class="glyphicon glyphicon-eye-open"></span>', $url, [
Qiang Xue committed
90
					'title' => Yii::t('yii', 'View'),
Alexander Makarov committed
91
				]);
Qiang Xue committed
92 93 94
			};
		}
		if (!isset($this->buttons['update'])) {
95
			$this->buttons['update'] = function ($url, $model) {
Alexander Makarov committed
96
				return Html::a('<span class="glyphicon glyphicon-pencil"></span>', $url, [
Qiang Xue committed
97
					'title' => Yii::t('yii', 'Update'),
Alexander Makarov committed
98
				]);
Qiang Xue committed
99 100 101
			};
		}
		if (!isset($this->buttons['delete'])) {
102
			$this->buttons['delete'] = function ($url, $model) {
Alexander Makarov committed
103
				return Html::a('<span class="glyphicon glyphicon-trash"></span>', $url, [
Qiang Xue committed
104 105 106
					'title' => Yii::t('yii', 'Delete'),
					'data-confirm' => Yii::t('yii', 'Are you sure to delete this item?'),
					'data-method' => 'post',
Alexander Makarov committed
107
				]);
Qiang Xue committed
108 109 110 111 112
			};
		}
	}

	/**
113 114 115 116
	 * Creates a URL for the given action and model.
	 * This method is called for each button and each row.
	 * @param string $action the button name (or action ID)
	 * @param \yii\db\ActiveRecord $model the data model
117
	 * @param mixed $key the key associated with the data model
118 119
	 * @param integer $index the current row index
	 * @return string the created URL
Qiang Xue committed
120
	 */
121
	public function createUrl($action, $model, $key, $index)
Qiang Xue committed
122 123
	{
		if ($this->urlCreator instanceof Closure) {
124
			return call_user_func($this->urlCreator, $action, $model, $key, $index);
Qiang Xue committed
125
		} else {
126
			$params = is_array($key) ? $key : ['id' => (string)$key];
127 128
			$route = $this->controller ? $this->controller . '/' . $action : $action;
			return Yii::$app->controller->createUrl($route, $params);
Qiang Xue committed
129 130 131 132
		}
	}

	/**
133
	 * @inheritdoc
Qiang Xue committed
134
	 */
135
	protected function renderDataCellContent($model, $key, $index)
Qiang Xue committed
136
	{
137
		return preg_replace_callback('/\\{([\w\-\/]+)\\}/', function ($matches) use ($model, $key, $index) {
Qiang Xue committed
138
			$name = $matches[1];
139
			if (isset($this->buttons[$name])) {
140 141
				$url = $this->createUrl($name, $model, $key, $index);
				return call_user_func($this->buttons[$name], $url, $model);
Qiang Xue committed
142 143 144 145 146 147
			} else {
				return '';
			}
		}, $this->template);
	}
}