芝麻web文件管理V1.00
编辑当前文件:/home2/sdektunc/airport-back/vendor/yiisoft/yii2/grid/ActionColumn.php
[ * // ... * [ * 'class' => ActionColumn::class, * // you may configure additional properties here * ], * ] * ``` * * For more details and usage information on ActionColumn, see the [guide article on data widgets](guide:output-data-widgets). * * @author Qiang Xue
* @since 2.0 */ class ActionColumn extends Column { /** * {@inheritdoc} */ public $headerOptions = ['class' => 'action-column']; /** * @var string|null 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; /** * @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. * * As an example, to only have the view, and update button you can add the ActionColumn to your GridView columns as follows: * * ```php * ['class' => 'yii\grid\ActionColumn', 'template' => '{view} {update}'], * ``` * * @see buttons */ public $template = '{view} {update} {delete}'; /** * @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, $key) { * // return the button HTML code * } * ``` * * where `$url` is the URL that the column creates for the button, `$model` is the model object * being rendered for the current row, and `$key` is the key of the model in the data provider array. * * You can add further conditions to the button, for example only display it, when the model is * editable (here assuming you have a status field that indicates that): * * ```php * [ * 'update' => function ($url, $model, $key) { * return $model->status === 'editable' ? Html::a('Update', $url) : ''; * }, * ], * ``` */ public $buttons = []; /** * @var array button icons. The array keys are the icon names and the values the corresponding html: * ```php * [ * 'eye-open' => '
', * 'pencil' => Html::tag('span', '', ['class' => 'glyphicon glyphicon-pencil']) * ] * ``` * Defaults to FontAwesome 5 free svg icons. * @since 2.0.42 * @see https://fontawesome.com */ public $icons = [ 'eye-open' => '
', 'pencil' => '
', 'trash' => '
' ]; /** @var array visibility conditions for each button. The array keys are the button names (without curly brackets), * and the values are the boolean true/false or the anonymous function. When the button name is not specified in * this array it will be shown by default. * The callbacks must use the following signature: * * ```php * function ($model, $key, $index) { * return $model->status === 'editable'; * } * ``` * * Or you can pass a boolean value: * * ```php * [ * 'update' => \Yii::$app->user->can('update'), * ], * ``` * @since 2.0.7 */ public $visibleButtons = []; /** * @var callable|null 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()]] * Since 2.0.10 it can accept additional parameter, which refers to the column instance itself: * * ```php * function (string $action, mixed $model, mixed $key, integer $index, ActionColumn $this) { * //return string; * } * ``` * * If this property is not set, button URLs will be created using [[createUrl()]]. */ public $urlCreator; /** * @var array html options to be applied to the [[initDefaultButton()|default button]]. * @since 2.0.4 */ public $buttonOptions = []; /** * {@inheritdoc} */ public function init() { parent::init(); $this->initDefaultButtons(); } /** * Initializes the default button rendering callbacks. */ protected function initDefaultButtons() { $this->initDefaultButton('view', 'eye-open'); $this->initDefaultButton('update', 'pencil'); $this->initDefaultButton('delete', 'trash', [ 'data-confirm' => Yii::t('yii', 'Are you sure you want to delete this item?'), 'data-method' => 'post', ]); } /** * Initializes the default button rendering callback for single button. * @param string $name Button name as it's written in template * @param string $iconName The part of Bootstrap glyphicon class that makes it unique * @param array $additionalOptions Array of additional options * @since 2.0.11 */ protected function initDefaultButton($name, $iconName, $additionalOptions = []) { if (!isset($this->buttons[$name]) && strpos($this->template, '{' . $name . '}') !== false) { $this->buttons[$name] = function ($url, $model, $key) use ($name, $iconName, $additionalOptions) { switch ($name) { case 'view': $title = Yii::t('yii', 'View'); break; case 'update': $title = Yii::t('yii', 'Update'); break; case 'delete': $title = Yii::t('yii', 'Delete'); break; default: $title = ucfirst($name); } $options = array_merge([ 'title' => $title, 'aria-label' => $title, 'data-pjax' => '0', ], $additionalOptions, $this->buttonOptions); $icon = isset($this->icons[$iconName]) ? $this->icons[$iconName] : Html::tag('span', '', ['class' => "glyphicon glyphicon-$iconName"]); return Html::a($icon, $url, $options); }; } } /** * 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\ActiveRecordInterface $model the data model * @param mixed $key the key associated with the data model * @param int $index the current row index * @return string the created URL */ public function createUrl($action, $model, $key, $index) { if (is_callable($this->urlCreator)) { return call_user_func($this->urlCreator, $action, $model, $key, $index, $this); } $params = is_array($key) ? $key : ['id' => (string) $key]; $params[0] = $this->controller ? $this->controller . '/' . $action : $action; return Url::toRoute($params); } /** * {@inheritdoc} */ protected function renderDataCellContent($model, $key, $index) { return preg_replace_callback('/\\{([\w\-\/]+)\\}/', function ($matches) use ($model, $key, $index) { $name = $matches[1]; if (isset($this->visibleButtons[$name])) { $isVisible = $this->visibleButtons[$name] instanceof \Closure ? call_user_func($this->visibleButtons[$name], $model, $key, $index) : $this->visibleButtons[$name]; } else { $isVisible = true; } if ($isVisible && isset($this->buttons[$name])) { $url = $this->createUrl($name, $model, $key, $index); return call_user_func($this->buttons[$name], $url, $model, $key); } return ''; }, $this->template); } }