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
),
));
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
),
));
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.