简述Yii 的CGridView如何使用及怎么用model的search搜索

来源：互联网发布：mac硬盘默认名称编辑：程序博客网时间：2024/04/27 20:06

Yii的CGridview挂件可以自动生成数据列表，很适合在后台管理页面使用。

但Yii的文档还是很缺乏，只能在 class reference 中找到一些简单的说明，可并不直观。在这里总结下CGridview的用法。

在模板页面中，可以这样来使用CGridview：

$this->widget('zii.widgets.grid.CGridView', array(

'dataProvider'=>$dataProvider,

'selectableRows' => true,

//'selectionChanged' => '',

//'emptyText' => 'it is empy',

//'actionPrefix' => '', //作用还不明确

//'ajaxVar'=>'', //作用还不明确

//ajaxUpdate => true,

//'beforeAjaxUpdate' => '', //作用还不明确

//afterAjaxUpdate => 'string', //作用还不明确

//'enablePagination' => true,

//'enableSorting' => true,

//'hasFooter' => true,

//'hiddenHeader' => false,

//'pager'=>'',

'columns'=>array(

'title', // display the 'title' attribute

'category.name', // display the 'name' attribute of the 'category' relation

'content:html', // display the 'content' attribute as purified HTML

array( // display 'create_time' using an expression

'name'=>'create_time',

'value'=>'date("M j, Y", $data->create_time)',

array( // display 'author.username' using an expression

'name'=>'authorName',

'value'=>'$data->author->username',

array( // display a column with "view", "update" and "delete" buttons

'class'=>'CButtonColumn',

));

dataProvider参数：

接收来自CActiveDataProvider的数组，每个数组元素都是一个当前table的model。

gii自动生成的Model类中自带一个search()方法，rules()方法的规则数组中最后一个规则也是和search有关的，这些是为了方便在controller中对数据进行筛选或者说搜索，而CGridview正可以利用Model的这些特性。dbProvider接收的值可以直接是：

'dataProvider'=>$model->search()

一个简单的例子：

controller的方法

function actionList()

{

$model = new Member('search');

if(isset($_GET['Member']))

{

$model->attributes = $_GET['Member'];

}

$this->render('list',array('model'=>$model));

}

view视图的内容

<html>

<body>

<?php

$this->widget('zii.widgets.Grid.CGridView',array(

'dataProvider' => $model->search(),

'filter' => $model,

'filterPosition' => 'header', //

'columns' => array(

'name',

'email',

));

</body>

</html>

视图中CGridview的参数filter，他的值应该是当前table的Model，如果filter获得了赋值，则这个CGridview可以对数据进行筛选搜索了；filterPosition可以有三个值，header/body/footer，用来控制字段的搜索输入框显示在列的头部、中部还是尾部，如果为空，则不会显示系统自带的这个搜索输入框。说实话CGridview自带的这个输入框有点太不人性化了，一点也不像常见搜索表单，所以我建议不要显示系统自带的搜索框，而是自行写一个搜索框，最简单像这样：

<input type="button" value="搜索" onclick="submitSearch('<?=url($this->route)?>','Member','name')">

function submitSearch(url,model,id)

{

var value = document.getElementById(model+'_'+id).value;

document.location.href = url + '&' + model + '['+ id + ']=' + value;

}

</script>

如果还要实现ajax的功能可以自行对代码进行一些小修改即可。

emptyText参数

当一条数据也没有获取到时，就会显示这个参数设定的提示信息，如“没有找到任何数据”

ajaxUpdate参数：

是否启用CGridview的ajax操作效果，如果设为true，删除、排序这些操作会自动以ajax方式来实现

enablePagination 参数

是否启用分页

enableSoring 参数

是否启用数据排序功能

hasFooter 参数

CGridview的表格是否有脚部

hiddenHeader 参数

是否隐藏CGridview表格的头部

pager参数

pager类显示时用到的参数

selectableRows参数

是否在每行数据行首显示一个checkbox以及一个全选checkbox

selectionChanged参数

当数据选中状态变化后要调用执行的js函数

showTableOnEmpty参数

当没有数据时，是否显示CGridview表格

summaryText参数

显示的摘要信息