CGridView 是Yii Framework Zii的組件, 以表格的形式顯示數據,CGridView 也支持分頁和排序,CGridView最基本的用法和ListView相似,經過設置 data provider。web
GridView缺省顯示了全部的字段,並使用缺省的格式顯示字段,若是須要控制字段顯示和格式,能夠經過配置 CGridView::columns屬性來實現。GridView的每列爲一個CGridColumn對象:api
- CGridColumn爲全部Grid 列表項的基類,表格的每例能夠有一個表頭,多個數據單元,和一個可選的表尾單元格。
- CButtonColumn 表示該單元格爲一個或多個按鈕,缺省顯示三個按鈕, 「view」, 「update」 和」delete」,能夠經過設置 buttons 和 template來更改。
- CCheckBoxColumn 表示該單元格爲Checkbox,支持只讀,單選或多選,經過配置selectableRows來修改
- CDataColumn 表示該單元爲數據或是表達式,經過配置name或value,前者表示數據模型的屬性名稱,後者代碼一個PHP表達式。
- CLinkColumn 表示一個超連接,經過配置 label , url或 imageUrl來設置連接。
示例代碼:yii
modelide
1 |
public function allBranchs() { |
2 |
$criteria = new CDbCriteria; |
3 |
$criteria ->with = 'parent' ; |
4 |
return new CActiveDataProvider( $this , array ( |
5 |
'criteria' => $criteria , |
viewui
01 |
$this ->widget( 'zii.widgets.grid.CGridView' , array ( |
02 |
'dataProvider' => $model ->allBranchs(), |
04 |
'maxButtonCount' => '7' , |
06 |
'template' => '{pager}{summary}{items}{pager}' , |
09 |
'class' => 'CCheckBoxColumn' , |
11 |
'value' => $model ->id, |
16 |
'header' => 'Parent Name' , |
17 |
'name' => 'parent.name' , |
24 |
'class' => 'CButtonColumn' , |
26 |
'deleteConfirmation' => '肯定刪除?' , |
這裏是用 CActiveDataProvider 來做爲data provider,也能夠用CArrayDataProvider 和 CSqlDataProvider。this
顯示效果:url