現在記錄下Gridview的相關內容,也是強迫症犯了,Yii2自帶的Gridview雖然不錯,但是過濾欄如果一些字段用不著,不會自動合並成一行,當然也可以過濾欄不用,而是在最上方自己寫一些需要檢索的數據,但是這樣很麻煩,還要自己去規劃樣式,寫檢索什麼的。正好在搜索將檢索欄和標題合並時,看到了kartik-v/yii2-grid可以實現這些功能,而且還自帶導出excel、csv等數據,所以也順便試了下它的功能,調出了自己喜歡的樣式。在用kartik-v的Gridview之前我們還是要了解Yii2自帶的Gridview的功能的,大體常用的一些方法如下:
1、Yii默認有四種樣式的列,分別為Data column(默認)、Action column(操作)、Checkbox column(可選中)、Serial column(帶序列號)
2、標題名字會根據Model中的attributeLabels()方法,來自動替換成對應的中文。當然也可以通過‘label’來自己定義,而‘attribute’則是指定根據哪個字段排序。其它的像是'visible'來隱藏顯示,'header'顯示頭部內容,'headerOptions'來定義css或style樣式等等。
[ 'label'=>'你想要的名稱', 'attribute'=>'id',//可以排序的字段 ]
3、自定義顯示頁數和排序字段,如果用到了searchModel,則需要在searchModel的search方法中定義,否則,需要在Controller中定義:
$dataProvider = new ActiveDataProvider([ 'query' => $query, 'pagination' => [ 'pageSize' => 15,//如果不定義,默認為20 ], 'sort' => ['attributes' => ['id']],//如果定義,則只能按照id來排序,否則所有字段都可以 ]);
4、下拉菜單檢索,好比根據下拉菜單檢索用戶狀態,則需要先在model中定義相關的方法,然後在Gridview中再做處理:
//Model中,定義一個靜態方法 const STATUS_DELETED = 0; const STATUS_ACTIVE = 10; public static function getZhStatus($status=false){ $status_array= [ ''=>'請選擇', self::STATUS_DELETED=>'禁止', self::STATUS_ACTIVE=>'正常' ]; return $status==false?$status_array:ArrayHelper::getValue($status_array,$status,'未知'); } //Gridview中 [ 'attribute' => 'status', 'filter'=>Html::activeDropDownList($searchModel,'status',User::getZhStatus(),['class' => 'form-control ']), 'value'=>function($data){ return User::getZhStatus($data->status); }, ],
5、格式化時間,有好幾種方法:
方法一:類似上面的定義回調函數
[ 'attribute'=>'created_at', 'value'=>function($data){ return date('Y-m-d',$data->created_at); }, ]
方法二:用Gridview自帶的format配置
[ 'attribute'=>'created_at', 'format'=>['date','php:Y-m-d'], 'value'=>'created_at', ],
方法三:首先在config中配置好你的時間格式,否則會是英文格式的,然後再在Gridview中處理。
//在common/config/main.php中定義自己的時間、金錢等的格式 'components' => [ 'formatter' => [ 'dateFormat' => 'yyyy-MM-dd', 'datetimeFormat' => 'yyyy-MM-dd HH:mm:ss', 'decimalSeparator' => ',', 'thousandSeparator' => ' ', 'currencyCode' => 'CNY', ], ],
這裡用到了快速寫的一種方式:“attribute:format:label”(屬性:格式:標簽)這種格式,詳情點擊這裡的api文檔。所以我們這樣就可以了:(如果定義了上方,則方法二可以直接'format'=>'date'即可以正確顯示)
'created_at:date',
6、顯示超鏈接或圖片,都是用的回調函數的方法,這裡以超鏈接為例,注意format需要為'raw’,不對結果做任何格式化處理,具體的格式化方面可以點這裡看看。
[ 'attribute'=>'id', 'value'=>function($model, $key, $index, $column){ return Html::a($model->id,['user/view','id'=>$model->id],['class' => 'profile-link','target'=>'_blank']); }, 'format' => 'raw', ],
7、關聯表單顯示,這個地方直接看指南吧,點這裡看,總之就是如果管理表單設置好後,直接用類似order.name這種就可以直接顯示使用,如果想要檢索排序,則需要在searchModel的rulers規則方法和attributes屬性方法中將此字段寫入,在search方法中添加andFilterWhere的檢索,以及用$query->joinWith關聯字段,$dataProvider->sort->attributes[]添加排序等。
8、自定義Action Column按鈕,
[ 'class' => 'yii\grid\ActionColumn', 'header'=>'操作', 'headerOptions'=>['width'=>'120'], 'template' => '{view} {update} {delete} {forbid} ', 'buttons'=>[ 'forbid'=>function($url,$model){ return Html::a('<i class="glyphicon glyphicon-remove-circle"></i>',['user/forbid','id'=>$model->id]); } ], ]
以上是Yii2自帶的Gridview的用法。再說下kartik-v/yii2-grid,官方文檔及demo講的比較全了,它比原生的多了幾個列的形式,例如Editable Column(可編輯)、Radio Column(單選框)等,還多了一些其它功能,例如滾動時可以固定標題欄方便查看、可以總計、導出svn,excel等格式。這裡稍微說下:
一開始安裝完成後可能會報錯pdf錯誤,因為這些關聯的還沒有安裝,可以按照提示安裝也可以先配置'export'=>false來取消導出功能,下面導出時會詳細配置。
1、整體結構如下圖:
2、上圖中各個部分非常靈活的顯示或隱藏,例如我不想要header,但是還想顯示共多少頁這個summary,可以將其放在before中,可以如下設置:
'panel' => [ 'heading'=>false,//不要了 'before'=>'<div>//放在before中,前面的div主要是想讓它好看 ],
當然上面的需求我們也可以直接用panelHeadingTemplate和panelBeforeTemplate來重新組裝,具體可以查看Layout Templates小章節。
3、一些有用的小設置
'responsive'=>true,//自適應,默認為true 'hover'=>true,//鼠標移動上去時,顏色變色,默認為false 'floatHeader'=>true,//向下滾動時,標題欄可以fixed,默認為false 'showPageSummary'=>true,//顯示統計欄,默認為false //column中的一些設置 'columns' => [ [ 'class' => '\kartik\grid\CheckboxColumn', 'rowSelectedClass' => GridView::TYPE_INFO, 'visible'=>true,//不顯示,代碼也沒有 'hidden'=>true,//隱藏,代碼還有,導出csv等時還存在 'hiddenFromExport'=>true,//雖然顯示,但導出csv時忽略掉 'pageSummary'=>'總計',//可以是字符串,當為true時,自動合計 'mergeHeader'=>true,//合並標題和檢索欄 ], ]
4、{toggleData}設置,主要是用來顯示分頁還是全部數據顯示
'toggleDataOptions'=>[ 'maxCount' => 200,//當超過200條時,此按鈕隱藏,以免數據太多造成加載問題 // 'minCount' => 10,//當超過10條,點擊時才會下面的提示 'confirmMsg' => '總共'. number_format($dataProvider->getTotalCount()).'條數據,確定要顯示全部?',//點擊時的確認 ],
5、{export}設置,可導出excel,csv,pdf等各種類型的文件,下面為導出csv的格式,如果在exportConfig只配置了csv,則只顯示導出csv,如果還想導出excel等格式,需要在exportConfig中添加。我在這裡導出csv時,不管設置編碼是gbk還是utf,用excel2013打開時都是中文亂碼,而用sublime等編輯器打開則正常,(導出excel格式則正常),有知道此問題的朋友,麻煩留言指教。
'export'=>[ 'fontAwesome'=>'fa fa-share-square-o',//圖標 'target'=>'_blank',//在新標簽打開 'encoding'=>'gbk',//編碼 ], 'exportConfig' => [ GridView::CSV => [ 'label' => '導出CSV', 'iconOptions' => ['class' => 'text-primary'], 'showHeader' => true, 'showPageSummary' => true, 'showFooter' => true, 'showCaption' => true, 'filename' => '用戶表'.date("Y-m-d"), 'alertMsg' => '確定要導出CSV格式文件?', 'options' => [ 'title'=>'', ], 'mime' => 'application/csv', 'config' => [ 'colDelimiter' => ",", 'rowDelimiter' => "\r\n", ], ], ],
基本也就這麼多,附上我自己還比較滿意設置的樣式截圖:(kartik-v/yii2-grid的樣式依賴於bootstrap,與adminlte的表格樣式相沖突,尤其是在合並標題欄和檢索欄時,合並的下方邊框會變粗,試了好多設置讓其全部都加粗都不行,最後只能妥協,修改kartik-v/yii2-grid的kv-merged-header的默認樣式,加了這一段:$this->registerCss(".kv-merged-header{border-bottom:1px solid #eee !important}");,勉強看得過去。)
本來還想繼續寫下美化alert,confirm等彈出框及自動關閉什麼的擴展以及批量刪除等的代碼來著,但是kartik-v/yii2-dialog這個就是安裝時不停出錯。再找找有什麼替代的到時候再補充吧。寫這個途中火狐崩潰兩次,重寫了好大段內容,哭死!