YII中CListView列表形式的模板設置，包括pager和sorter的細節

其實在API中寫得挺詳細的，但我沒記住，因此決定在此寫下本身的方法，加強記憶。

CListView的API：http://www.yiiframework.com/doc/api/1.1/CListView

分頁器CLinkPager的API：http://www.yiiframework.com/doc/api/1.1/CLinkPager

 

如下較全面的定義了全部可配置項：

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

    'dataProvider'=>$dataProvider,

    'itemView'=>'_view',

    'template'=>'<div class="summary">{summary}</div><div class="sorter">{sorter}</div><div class="list">{items}</div><div class="pager">{pager}</div>',

    //template是整個CListView的模板：

    //{summary}的位置會顯示基本描述，可修改summaryText項來設置描述的模板

    //{sorter}的位置會顯示更改排序方式的按鈕，須要定義sortableAttributes項來描述哪一屬性是可排序的

    //{items}的位置會顯示列表，列表中每一項的格式來自itemView項定義的文件

    //{pager}的位置會顯示分頁器，可經過定義pager項來設定分頁器的顯示方式

 

    'summaryCssClass'=>'summary_container',//定義summary的div容器的class

    'summaryText'=>'共{count}條，當前頁顯示第{start}-{end}條',

    //定義summary的顯示內容，其中可用到如下變量：

    //{start}表示本頁的第一條是所有中的第幾條

    //{end}表示本頁最後一條是所有中的第幾條

    //{count}表示所有共幾條

    //{page}表示當前頁碼

    //{pages}表示總頁數

 

    'sortableAttributes'=>array('title','create_time'),//定義可排序的屬性

    'sorterCssClass'=>'sorter_container',//定義sorter的div容器的class

    'sorterHeader'=>'更改排序：',//定義的文字顯示在sorter可排序屬性的前面

    'sorterFooter'=>'',//定義的文字顯示在sorter可排序屬性的後面

 

    'pagerCssClass'=>'pager_container',//定義pager的div容器的class

    'pager'=>array(

        'class'=>'CLinkPager',//定義要調用的分頁器類，默認是CLinkPager，須要徹底自定義，還能夠重寫一個，參考個人另外一篇博文：http://blog.sina.com.cn/s/blog_71d4414d0100yu6k.html
        'cssFile'=>false,//定義分頁器的要調用的css文件，false爲不調用，不調用則須要親本身css文件裏寫這些樣式
        'header'=>'轉往分頁：',//定義的文字將顯示在pager的最前面

        'footer'->'',//定義的文字將顯示在pager的最後面
        'firstPageLabel'=>'首頁',//定義首頁按鈕的顯示文字
        'lastPageLabel'=>'尾頁',//定義末頁按鈕的顯示文字
        'nextPageLabel'=>'下一頁',//定義下一頁按鈕的顯示文字
        'prevPageLabel'=>'前一頁',//定義上一頁按鈕的顯示文字

        //關於分頁器這個array，具體還有不少屬性，可參考CLinkPager的API    ),));