分頁

分頁實現(xiàn)

版本 新增功能
5.0.5 分頁方法返回think\Paginator對象(用法不變)
5.0.1 支持第二個參數(shù)直接傳入總記錄數(shù)

ThinkPHP5.0內(nèi)置了分頁實現(xiàn),要給數(shù)據(jù)添加分頁輸出功能在5.0變得非常簡單,可以直接在Db類查詢的時候調(diào)用paginate方法:

// 查詢狀態(tài)為1的用戶數(shù)據(jù) 并且每頁顯示10條數(shù)據(jù)
$list = Db::name('user')->where('status',1)->paginate(10);
// 把分頁數(shù)據(jù)賦值給模板變量list
$this->assign('list', $list);
// 渲染模板輸出
return $this->fetch();

也可以改成模型的分頁查詢代碼:

// 查詢狀態(tài)為1的用戶數(shù)據(jù) 并且每頁顯示10條數(shù)據(jù)
$list = User::where('status',1)->paginate(10);
// 把分頁數(shù)據(jù)賦值給模板變量list
$this->assign('list', $list);
// 渲染模板輸出
return $this->fetch();

模板文件中分頁輸出代碼如下:

<div>
<ul>
{volist name='list' id='user'}
    <li> {$user.nickname}</li>
{/volist}
</ul>
</div>
{$list->render()}

也可以單獨賦值分頁輸出的模板變量

// 查詢狀態(tài)為1的用戶數(shù)據(jù) 并且每頁顯示10條數(shù)據(jù)
$list = User::where('status',1)->paginate(10);
// 獲取分頁顯示
$page = $list->render();
// 模板變量賦值
$this->assign('list', $list);
$this->assign('page', $page);
// 渲染模板輸出
return $this->fetch();

模板文件中分頁輸出代碼如下:

<div>
<ul>
{volist name='list' id='user'}
    <li> {$user.nickname}</li>
{/volist}
</ul>
</div>
{$page}

默認情況下,生成的分頁輸出是完整分頁功能,帶總分頁數(shù)據(jù)和上下頁碼,分頁樣式只需要通過樣式修改即可,完整分頁默認生成的分頁輸出代碼為:

<ul class="pagination">
<li><a href="?page=1">&laquo;</a></li>
<li><a href="?page=1">1</a></li>
<li class="active"><span>2</span></li>
<li class="disabled"><span>&raquo;</span></li>
</ul>

傳入總記錄數(shù)( V5.0.1

V5.0.1版本開始,支持傳入總記錄數(shù)而不會自動進行總數(shù)計算,例如:

// 查詢狀態(tài)為1的用戶數(shù)據(jù) 并且每頁顯示10條數(shù)據(jù) 總記錄數(shù)為1000
$list = User::where('status',1)->paginate(10,1000);
// 獲取分頁顯示
$page = $list->render();
// 模板變量賦值
$this->assign('list', $list);
$this->assign('page', $page);
// 渲染模板輸出
return $this->fetch();

分頁后數(shù)據(jù)處理 (V5.0.9

V5.0.9版本開始 支持分頁類后數(shù)據(jù)直接each遍歷處理,方便修改分頁后的數(shù)據(jù),而不是只能通過模型的獲取器來補充字段。

$list = User::where('status',1)->paginate()->each(function($item, $key){
    $item->nickname = 'think';
});

如果是Db類操作分頁數(shù)據(jù)的話,each方法的閉包函數(shù)中需要使用返回值,例如:

$list = Db::name('user')->where('status',1)->paginate()->each(function($item, $key){
    $item['nickname'] = 'think';
    return $item;
});

簡潔分頁

如果你僅僅需要輸出一個 僅僅只有上下頁的分頁輸出,可以使用下面的簡潔分頁代碼:

// 查詢狀態(tài)為1的用戶數(shù)據(jù) 并且每頁顯示10條數(shù)據(jù)
$list = User::where('status',1)->paginate(10,true);
// 把分頁數(shù)據(jù)賦值給模板變量list
$this->assign('list', $list);
// 渲染模板輸出
return $this->fetch();

簡潔分頁模式的輸出代碼為:

<ul class="pager">
<li><a href="?page=1">&laquo;</a></li>
<li class="disabled"><span>&raquo;</span></li>
</ul>

由于簡潔分頁模式不需要查詢總數(shù)據(jù)數(shù),因此可以提高查詢性能。

分頁參數(shù)

主要的分頁參數(shù)如下:

參數(shù) 描述
list_rows 每頁數(shù)量
page 當前頁
path url路徑
query url額外參數(shù)
fragment url錨點
var_page 分頁變量
type 分頁類名

分頁參數(shù)的設(shè)置方式有兩種,第一種是在配置文件中定義,例如:

//分頁配置
'paginate'               => [
    'type'     => 'bootstrap',
    'var_page' => 'page',
],

type屬性支持命名空間,例如:

//分頁配置
'paginate'               => [
    'type'     => '\org\page\bootstrap',
    'var_page' => 'page',
],

也可以在調(diào)用分頁方法的時候傳入,例如:

$list = Db::name('user')->where('status',1)->paginate(10,true,[
    'type'     => 'bootstrap',
    'var_page' => 'page',
]);
文檔最后更新時間:2018-04-26 10:53:13

文檔
目錄

深色
模式

切換
寬度