Yii2 advanced grid

The extension provides different columns for yii\grid\GridView widget. You can see it on this page.

There is a GridView demo below.

Showing 21-30 of 50 items.

ID	Name + slug	Price	Is Active	Quantity	Reserved
21	Product #21 `product-21`	1.1186345345332 ^{↑ 0%}	OffOn	100	71%
22	Product #22 `product-22`	10345345 ^{↓ -99%}	OffOn	100	98%
23	Product #23 `product-23`	52000345345 ^{↑ 362389%}	OffOn	100	76%
24	Product #24 `product-24`	30345345 ^{↑ 0%}	OffOn	100	87%
25	Product #25 `product-25`	11111111111345 ^{↓ -96%}	OffOn	100	7%
26	Product #26 `product-26`	155345 ^{↑ 2806%}	OffOn	100	76%
27	Product #27 `product-27`	1231345 ^{↑ 9874%}	OffOn	100	56%
28	Product #28 `product-28`	1230345 ^{↑ 5170%}	OffOn	100	53%
29	Product #29 `product-29`	8034345 ^{↑ 85874%}	OffOn	100	97%
30	Product #30 `product-30`	22222 ^{↓ -96%}	OffOn	100	25%

DifferenceColumn

The column allows to show a current value and difference between it and last value.

Parameters

attribute string the attribute name associated with this column
template string|callable the string output template or the render callable
difference string|callable the difference attribute name or the calculation callable
differenceInPercents bool whether to show difference in percents
another fields of yii\grid\DataColumn

Example

[
    'class' =>\yiister\grid\widgets\DifferenceColumn::className(),
    'attribute' => 'price',
    'difference' => function ($model, $column) {
        return $model->price - $model->old_price;
    },
    'differenceInPercents' => true,
    'template' => '{value} <sup class="label label-info">{difference}%</sup>',
],

InputColumn

The column allows to update value via ajax.

Parameters

attribute string the attribute name associated with this column
updateAction array|string the update action route. See ColumnUpdateAction
size string the input size
another fields of yii\grid\DataColumn

Example

[
    'class' => \yiister\grid\widgets\InputColumn::className(),
    'attribute' => 'price',
    'updateAction' => '/projects/column-update',
],

MultifieldColumn

The column allows to show some fields in one column by template.

Parameters

attribute string the attribute name associated with this column
attributes string[] the secondary attribute names array
template string|callable the string output template or the render callable
another fields of yii\grid\DataColumn

Example

[
    'class' => \yiister\grid\widgets\MultifieldColumn::className(),
    'attribute' => 'name',
    'label' => 'Name + slug',
    'attributes' => ['slug'],
    'template' => '{name}<br /><small><code>{slug}</code></small>',
],

ProgressColumn

The column allows to show a progressbar for associated attribute value.

Parameters

attribute string the attribute name associated with this column
percent bool whether to show a percents instead of an attribute value
minValue int the minimum attribute value
maxValue int the maximum attribute value
showText bool whether to show the text
size string the progress bar size
progressBarClass string|callback the progress bar class
isStriped bool whether to stripe the progress bar
isAnimated bool whether to animate the progress bar
another fields of yii\grid\DataColumn

Example

[
    'class' => \yiister\grid\widgets\ProgressColumn::className(),
    'attribute' => 'reserved',
    'size' => \yiister\grid\widgets\ProgressColumn::SIZE_LARGE,
    'isStriped' => true,
    'progressBarClass' => function ($model, $column) {
        return $model->{$column->attribute} > 15
            ? \yiister\grid\widgets\ProgressColumn::STYLE_SUCCESS
            : \yiister\grid\widgets\ProgressColumn::STYLE_WARNING;
    },
],

ToggleColumn

The column allows to show toggle buttons with ability to change value via ajax request.

Parameters

attribute string the attribute name associated with this column

buttons array of values to rendering
Data format:

[
    'value_one' => 'The first label',
    'value_two' => 'The second label',
]

updateAction array|string the update action route. See ColumnUpdateAction
another fields of yii\grid\DataColumn

Example

[
    'class' => \yiister\grid\widgets\ToggleColumn::className(),
    'attribute' => 'is_active',
    'updateAction' => '/projects/column-update',
],

ColumnUpdateAction

The action for column updating. It is used in ajax requests of some columns.

Parameters

allowedAttributes array of allowed classes with attributes in the next format

[
   'app\models\Page' => ['is_active'],
   'app\models\OrderStatus' => ['is_system', 'is_active', 'sort_order'],
]

Example

public function actions()
{
    return [
        'column-update' => [
            'class' => ColumnUpdateAction::className(),
            'allowedAttributes' => [
                'app\models\DemoProduct' => ['price', 'old_price', 'is_active'],
            ],
        ],
    ];
}