Yii2 GridView on steroids. A module with various modifications and enhancements to one of the most used widgets by Yii developers. The widget contains new additional Grid Columns with enhanced settings for Yii Framework 2.0. The widget also incorporates various Bootstrap 3.x styling options. Refer detailed documentation and/or a complete demo.
The latest version of the module is v1.9.0 released on 21-Aug-2014. Refer the CHANGE LOG for details.
With v1.9.0, the GridView by default has embedded Pjax support. To enable Pjax processing, set pjax
property to true
and control pjax behavior using pjaxSettings
.
NOTE: This extension depends on the kartik-v/yii2-widgets extension which in turn depends on the yiisoft/yii2-bootstrap extension. Check the composer.json for this extension's requirements and dependencies. Note: Yii 2 framework is still in active development, and until a fully stable Yii2 release, your core yii2-bootstrap packages (and its dependencies) may be updated when you install or update this extension. You may need to lock your composer package versions for your specific app, and test for extension break if you do not wish to auto update dependencies.
The extension has been created as a module to enable access to advanced features like download actions (exporting as csv, text, html, or xls). You should configure the module with a name of gridview
as shown below:
'modules' => [
'gridview' => [
'class' => '\kartik\grid\Module'
]
],
The following functionalities have been added/enhanced:
Control various options to style your grid table. Added containerOptions
to customize your grid table container. Enhancements for grid and columns to work with yii\widgets\Pjax.
Inbuilt support for Pjax. Enhancements for grid and columns to work with yii\widgets\Pjax
. Auto-reinitializes embedded javascript plugins when GridView is refreshed via Pjax. Added pjax
property to enable pjax and pjaxSettings
to customize the pjax behavior.
Add custom header or footer rows, above / below your default grid header and footer.
Allows the grid table to have a floating table header. Uses the JQuery Float THead plugin to display a seamless floating table header.
Allows configuration of GridView to be enclosed in a panel that can be styled as per Bootstrap 3.x. The panel will enable configuration of various sections to embed content/buttons, before and after header, and before and after footer.
This is a new feature added to the GridView widget. The page summary is an additional row above the footer - for displaying the summary/totals for the current GridView page. The following parameters are applicable to control this behavior:
showPageSummary
: boolean whether to display the page summary row for the grid view. Defaults tofalse
.pageSummaryRowOptions
: array, HTML attributes for the page summary row. Defaults to['class' => 'kv-page-summary warning']
.
This is a new feature added to the GridView widget. It allows you to export the displayed grid content as HTML, CSV, TEXT, or EXCEL. It uses the rendered grid data on client to convert to one of the format specified using JQuery. This is supported across all browsers. The following are new features added since release v1.6.0:
- Ability to preprocess and convert column data to your desired value before exporting. There is a new property
exportConversions
that can be setup in GridView. For example, this currently is set as a default to convert the HTML formatted icons for BooleanColumn to user friendly text likeActive
orInactive
after export. - Hide any row or column in the grid by adding one or more of the following CSS classes:
skip-export
: Will skip this element during export for all formats (html
,csv
,txt
,xls
).skip-export-html
: Will skip this element during export only forhtml
export format.skip-export-csv
: Will skip this element during export only forcsv
export format.skip-export-txt
: Will skip this element during export only fortxt
export format.skip-export-xls
: Will skip this element during export only forxls
(excel) export format. These CSS can be set virtually anywhere. For exampleheaderOptions
,contentOptions
,beforeHeader
etc.
The default Yii data column has been enhanced with various additional parameters. Refer documentation for details.
An enhanced data column that allows you to edit the cell content using kartik\editable\Editable widget. Refer documentation for details.
This is a new grid column class that extends the \kartik\grid\DataColumn class. It allows calculating formulae just like in spreadsheets - based on values of other columns in the grid. The formula calculation is done at grid rendering runtime and does not need to query the database. Hence you can use formula columns within another formula column. Refer documentation for details.
This is a new grid column class that extends the \kartik\grid\DataColumn class. It automatically converts boolean data (true/false) values to user friendly indicators or labels (that are configurable). Refer documentation for details. The following are new features added since release v1.6.0:
BooleanColumn
icons have been setup asICON_ACTIVE
andICON_INACTIVE
constants in GridView.
Enhancements of \yii\grid\ActionColumn
to include optional dropdown Action menu and work with the new pageSummary and a default styling to work for many scenarios. Refer documentation for details.
The following are new features added since release v1.6.0:
ActionColumn
content by default has been disabled to appear in export output. Theskip-export
CSS class has been set as default inheaderOptions
andcontentOptions
.
Enhancement of \yii\grid\SerialColumn
to work with the new pageSummary and a default styling to work for many scenarios. Refer documentation for details.
Enhancements of \yii\grid\CheckboxColumn
to work with the new pageSummary and a default styling to work for many scenarios. Refer documentation for details.
You can see detailed documentation and demonstration on usage of the extension.
The preferred way to install this extension is through composer.
Note: You must set the
minimum-stability
todev
in the composer.json file in your application root folder before installation of this extension.
Either run
$ php composer.phar require kartik-v/yii2-grid "dev-master"
or add
"kartik-v/yii2-grid": "dev-master"
to the require
section of your composer.json
file.
use kartik\grid\GridView;
$gridColumns = [
['class' => 'kartik\grid\SerialColumn'],
[
'class' => 'kartik\grid\EditableColumn',
'attribute' => 'name',
'pageSummary' => 'Page Total',
'vAlign'=>'middle',
'headerOptions'=>['class'=>'kv-sticky-column'],
'contentOptions'=>['class'=>'kv-sticky-column'],
'editableOptions'=>['header'=>'Name', 'size'=>'md']
],
[
'attribute'=>'color',
'value'=>function ($model, $key, $index, $widget) {
return "<span class='badge' style='background-color: {$model->color}'> </span> <code>" .
$model->color . '</code>';
},
'filterType'=>GridView::FILTER_COLOR,
'vAlign'=>'middle',
'format'=>'raw',
'width'=>'150px',
'noWrap'=>true
],
[
'class'=>'kartik\grid\BooleanColumn',
'attribute'=>'status',
'vAlign'=>'middle',
],
[
'class' => 'kartik\grid\ActionColumn',
'dropdown' => true,
'vAlign'=>'middle',
'urlCreator' => function($action, $model, $key, $index) { return '#'; },
'viewOptions'=>['title'=>$viewMsg, 'data-toggle'=>'tooltip'],
'updateOptions'=>['title'=>$updateMsg, 'data-toggle'=>'tooltip'],
'deleteOptions'=>['title'=>$deleteMsg, 'data-toggle'=>'tooltip'],
],
['class' => 'kartik\grid\CheckboxColumn']
];
echo GridView::widget([
'dataProvider' => $dataProvider,
'filterModel' => $searchModel,
'columns' => $gridColumns,
'containerOptions' => ['style'=>'overflow: auto'], // only set when $responsive = false
'beforeHeader'=>[
[
'columns'=>[
['content'=>'Header Before 1', 'options'=>['colspan'=>4, 'class'=>'text-center warning']],
['content'=>'Header Before 2', 'options'=>['colspan'=>4, 'class'=>'text-center warning']],
['content'=>'Header Before 3', 'options'=>['colspan'=>3, 'class'=>'text-center warning']],
],
'options'=>['class'=>'skip-export'] // remove this row from export
]
],
'toolbar' => Html::button('<i class="glyphicon glyphicon-plus"></i> ' .
Yii::t('kvgrid', 'Add Book'), ['type'=>'button', 'class'=>'btn btn-success']) . ' ' .
Html::a('<i class="glyphicon glyphicon-repeat"></i> ' .
Yii::t('kvgrid', 'Reset Grid'), ['grid-demo'], ['class' => 'btn btn-info']),
'pjax' => true,
'bordered' => true,
'striped' => false,
'condensed' => false,
'responsive' => true,
'hover' => true,
'floatHeader' => true,
'floatHeaderOptions' => ['scrollingTop' => $scrollingTop],
'showPageSummary' => true,
'panel' => [
'type' => GridView::TYPE_PRIMARY
],
]);
yii2-grid is released under the BSD 3-Clause License. See the bundled LICENSE.md
for details.