【详解】YII中CListView列表形式的模板设置,包括pager和sorter的细节

jerry Yii 2015年08月12日 收藏

以下较全面的定义了所有可配置项:

  1. $this->widget('zii.widgets.CListView', array(
  2.     'dataProvider'=>$dataProvider,
  3.     'itemView'=>'_view',
  4.     'template'=>'<div class="summary">{summary}</div><div class="sorter">{sorter}</div><div class="list">{items}</div><div class="pager">{pager}</div>',
  5.     //template是整个CListView的模板:
  6.     //{summary}的位置会显示基本描述,可修改summaryText项来设置描述的模板
  7.     //{sorter}的位置会显示更改排序方式的按钮,需要定义sortableAttributes项来描述哪一属性是可排序的
  8.     //{items}的位置会显示列表,列表中每一项的格式来自itemView项定义的文件
  9.     //{pager}的位置会显示分页器,可通过定义pager项来设定分页器的显示方式
  10.  
  11.     'summaryCssClass'=>'summary_container',//定义summary的div容器的class
  12.     'summaryText'=>'共{count}条,当前页显示第{start}-{end}条',
  13.     //定义summary的显示内容,其中可用到以下变量:
  14.     //{start}表示本页的第一条是全部中的第几条
  15.     //{end}表示本页最后一条是全部中的第几条
  16.     //{count}表示全部共几条
  17.     //{page}表示当前页码
  18.     //{pages}表示总页数
  19.  
  20.     'sortableAttributes'=>array('title','create_time'),//定义可排序的属性
  21.     'sorterCssClass'=>'sorter_container',//定义sorter的div容器的class
  22.     'sorterHeader'=>'更改排序:',//定义的文字显示在sorter可排序属性的前面
  23.     'sorterFooter'=>'',//定义的文字显示在sorter可排序属性的后面
  24.  
  25.     'pagerCssClass'=>'pager_container',//定义pager的div容器的class
  26.     'pager'=>array(
  27.         'class'=>'CLinkPager',//定义要调用的分页器类,默认是CLinkPager,需要完全自定义,还可以重写一个,参考我的另一篇博文:http://blog.sina.com.cn/s/blog_71d4414d0100yu6k.html
  28.         'cssFile'=>false,//定义分页器的要调用的css文件,false为不调用,不调用则需要亲自己css文件里写这些样式
  29.         'header'=>'转往分页:',//定义的文字将显示在pager的最前面
  30.         'footer'->'',//定义的文字将显示在pager的最后面
  31.         'firstPageLabel'=>'首页',//定义首页按钮的显示文字
  32.         'lastPageLabel'=>'尾页',//定义末页按钮的显示文字
  33.         'nextPageLabel'=>'下一页',//定义下一页按钮的显示文字
  34.         'prevPageLabel'=>'前一页',//定义上一页按钮的显示文字
  35.         //关于分页器这个array,具体还有很多属性,可参考CLinkPager的API
  36.     ),
  37. ));