这个分页导航条控件简单易用,适合各种需要分页导航的场合。配合定制的样式表,可以实现多种风格。QeePHP.com 官方网站也是使用该分页导航条控件。

使用说明

首先在查询时需要取得分页信息,例如:

// 分页查询
$page = intval($this->_context->page);
if ($page < 1) $page = 1;
 
// 构造查询对象
$select = Post::find()->limitPage($page, 10);
 
// 将分页信息和查询到的数据传递到视图
$this->_view['pagination'] = $select->getPagination();
$this->_view['posts']      = $select->getAll();

在视图中只需要一行代码即可显示出分页导航条:

<?php
$this->_control('pagination', 'my-pagination', array(
    'pagination' => $pagination,
));
?>

传递更多的参数

如果需要在点击页码时传递更多的 URL 参数,可以在构造控件时指定“url_args”选项,例如:

<?php
$this->_control('pagination', 'my-pagination', array(
    'pagination' => $pagination,
    'url_args'   => array('order' => 'click_counts'),
));
?>

上面代码传递了“order”参数给导航条,因此在点击页码时,URL 中会增加“order”参数。 附加参数和参数值是没有限制的,可以硬编码,也可以用一个数组来动态指定。

定制

导航条支持下列定制选项:

  • udi: 分页按钮对应的网址,采用 UDI 格式指定,例如“admin::posts/index”
  • length: 最多显示多少个分页按钮,默认为 9
  • slider: 当分页按钮超过 length 指定的个数时,首尾各省略多少个页码按钮
  • prev_label: 上一页按钮的文字
  • next_label: 下一页按钮的文字
  • url_args: 附加的 URL 参数

更多问题

如果使用中有问题,或者有修改和建议,请发到这里


已上传的文件

说 明: pagination-2009-02-06.zip
文 件: pagination-2009-02-06.zip (2.36 KB, 上传日期:2009-02-06 08:35)
统 计: 147 天内下载了 712 次

说 明: pagination-2009-01-05.zip
文 件: pagination-2009-01-05.zip (2.36 KB, 上传日期:2009-01-05 06:15)
统 计: 179 天内下载了 259 次