| 包 | system.web.widgets.pagers |
|---|---|
| 继承 | class CListPager » CBasePager » CWidget » CBaseController » CComponent |
| 源自 | 1.0 |
| 版本 | $Id: CListPager.php 2799 2011-01-01 19:31:13Z qiang.xue $ |
| 源码 |
CListPager显示一个下拉列表，其中包含导致不同目标页的选项。
公共属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| actionPrefix | string | actions的ID的前缀。 当微件在CController::actions中声明了 动作提供者，可以为其动作的ID指定前缀以区别 于别的微件或控制器。当微件用于控制器 的视图中时，必须配置同样的前缀。 | CWidget |
| controller | CController | 返回此微件所属的控制器。 | CWidget |
| currentPage | integer | 当前页的索引（从0开始）。缺省为0。 | CBasePager |
| footer | string | 分页按钮后面显示的文字。 | CListPager |
| header | string | 分页按钮前面显示的文字。默认为‘Go to page: ’。 | CListPager |
| htmlOptions | array | 关闭‘div’标签的HTML属性。 | CListPager |
| id | string | 返回此微件的ID。如果需要的话，将生产一个新的ID并将其返回。 | CWidget |
| itemCount | integer | 项目的总量。 | CBasePager |
| owner | CBaseController | 返回此微件的所有者或创建者。 | CWidget |
| pageCount | integer | 页数 | CBasePager |
| pageSize | integer | 每页包含项目的数量。 | CBasePager |
| pageTextFormat | string | 用于生成分页列表的格式化字符串。 使用sprintf函数执行格式化。 | CListPager |
| pages | CPagination | 返回此pager所用的分页信息。 | CBasePager |
| promptText | string | 作为下拉菜单列表的提示文字，默认为空，表示不提示。 | CListPager |
| skin | mixed | 微件使用的皮肤的名称。默认为“default”。 如果此属性设置为false，微件将不会有皮肤被使用。 | CWidget |
| viewPath | string | 返回包含此微件所需的视图文件的路径。 | CWidget |
公共方法
受保护方法
| 方法 | 描述 | 定义在 |
|---|---|---|
| createPageUrl() | 创建分页适用的URL。 | CBasePager |
| createPages() | 创建缺省分页。 | CBasePager |
| generatePageText() | 生成页码的列表选项。 | CListPager |
属性详细
public string $footer;
分页按钮后面显示的文字。
header
属性
public string $header;
分页按钮前面显示的文字。默认为‘Go to page: ’。
htmlOptions
属性
public array $htmlOptions;
关闭‘div’标签的HTML属性。
pageTextFormat
属性
public string $pageTextFormat;
用于生成分页列表的格式化字符串。 使用sprintf函数执行格式化。
promptText
属性
public string $promptText;
作为下拉菜单列表的提示文字，默认为空，表示不提示。
方法详细
generatePageText()
方法
|
protected string generatePageText(integer $page)
| ||
| $page | integer | zero-based page number |
| {return} | string | the list option for the page number |
protected function generatePageText($page)
{
if($this->pageTextFormat!==null)
return sprintf($this->pageTextFormat,$page+1);
else
return $page+1;
}
生成页码的列表选项。 可以重写该方法，自定义想要的显示。
init()
方法
|
public void init()
|
public function init()
{
if($this->header===null)
$this->header=Yii::t('yii','Go to page: ');
if(!isset($this->htmlOptions['id']))
$this->htmlOptions['id']=$this->getId();
if($this->promptText!==null)
$this->htmlOptions['prompt']=$this->promptText;
if(!isset($this->htmlOptions['onchange']))
$this->htmlOptions['onchange']="if(this.value!='') {window.location=this.value;};";
}
通过设置一些默认值初始化分页。
run()
方法
|
public void run()
|
public function run()
{
if(($pageCount=$this->getPageCount())<=1)
return;
$pages=array();
for($i=0;$i<$pageCount;++$i)
$pages[$this->createPageUrl($i)]=$this->generatePageText($i);
$selection=$this->createPageUrl($this->getCurrentPage());
echo $this->header;
echo CHtml::dropDownList($this->getId(),$selection,$pages,$this->htmlOptions);
echo $this->footer;
}
执行挂件。 这个方法重写了显示页码按钮的父类方法。