Yii Zii组件 CGridView 使用详解

CGridView 是Yii Framework  Zii的组件， 以表格的形式显示数据，CGridView 也支持分页和排序，CGridView最基本的用法和ListView类似，通过设置 data provider。

GridView缺省显示了所有的字段，并使用缺省的格式显示字段，如果需要控制字段显示和格式，可以通过配置 CGridView::columns属性来实现。GridView的每列为一个CGridColumn对象：

• CGridColumn为所有Grid 列表项的基类，表格的每例可以有一个表头，多个数据单元，和一个可选的表尾单元格。

• CButtonColumn 表示该单元格为一个或多个按钮，缺省显示三个按钮， “view”, “update” 和”delete”,可以通过设置 buttons 和 template来更改。

• CCheckBoxColumn 表示该单元格为Checkbox，支持只读，单选或多选，通过配置selectableRows来修改

• CDataColumn 表示该单元为数据或是表达式，通过配置name或value，前者表示数据模型的属性名称，后者代码一个PHP表达式。

• CLinkColumn 表示一个超链接，通过配置 label ， url或 imageUrl来设置链接。

示例代码：

model

1 publicfunctionallBranchs() {
2 $criteria= newCDbCriteria;
3 $criteria->with = 'parent';
4 returnnewCActiveDataProvider($this, array(
5 'criteria'=> $criteria,
6 ));
7 }

view

01 $this->widget('zii.widgets.grid.CGridView', array(
02 'dataProvider'=> $model->allBranchs(),
03 'pager'=> array(
04 'maxButtonCount'=> '7',
05 ),
06 'template'=> '{pager}{summary}{items}{pager}',
07 'columns'=> array(
08 array(
09 'class'=> 'CCheckBoxColumn',
10 'selectableRows'=>2,
11 'value'=> $model->id,
12 ),
13 'id',
14 'parent_id',
15 array(
16 'header'=> 'Parent Name',
17 'name'=> 'parent.name',
18 ),
19 'path',
20 'name',
21 'description',
22 'uid',
23 array(
24 'class'=> 'CButtonColumn',
25 'header'=>'操作',
26 'deleteConfirmation'=> '确定删除？',
27 ),
28 )
29 ));

这里是用 CActiveDataProvider 来作为data provider，也可以用CArrayDataProvider 和 CSqlDataProvider。

显示效果：