iT邦幫忙

第 11 屆 iThome 鐵人賽

DAY 27
1
Modern Web

從基礎學習 ThinkPHP系列 第 27

Day27-從基礎學習 ThinkPHP-分頁

  • 分享至 

  • xImage
  •  

前言

接下來讓我們講一個網站很常使用的功能,也就是分頁功能,本身 ThinkPHP 也有提供分頁功能,那該怎麼做呢?所以這一邊就會來介紹該如何使用分頁。

分頁

本身 ThinkPHP 是有提供分頁功能,只是是基礎樣式,只需要呼叫 paginate() 並搭配 HTML 標籤就可以達到需求,那該怎麼做呢?讓我們直接從程式碼來看,範例這邊我將會使用 about/controller/index.php 中的 all() 方法來當作範例修改,但是在那之前先讓我們看一下目前資料畫面 ↓

我已經將資料新增到 10 筆

接下來我只希望輸出 5 筆資料,接下來就換頁,我這邊直接複製 all() 然後再改寫成以下:

public function page() {
    $user = aboutModel::paginate(5);
    return $this->assign('user', $user)->fetch('page');
}

正常狀況來看,你應該就會看到資料只會顯示 5 筆 ↓

五筆資料

接下來建立一個 page.html 畫面,然後內容如下:

{layout name="layout" replace="[__ONEFORALL__]"/}
<div class="container">
  {volist name="user" id="list"}
  <ul class="list-group">
    <li class="list-group-item active">KEY:{$i}</li>
    <li class="list-group-item">姓名:{$list.name}</li>
    <li class="list-group-item">體重:{$list.weight}</li>
    <li class="list-group-item">身高:{$list.height}</li>
  </ul>
  {/volist}
  {$user|raw}
</div>

這邊重點在於 {$user|raw},ThinkPHP 會自動替換成分頁功能 ↓

基礎樣式

另外你可能會看到另一種寫法 {$user->render()|raw},這種寫法結果也是一樣,所以自己挑一個自己喜歡的寫法就可以了。

修改分頁樣式

基本上要修改分類樣式是稍微麻煩一點,但是原本樣式比較簡易,所以我們就來修改吧!

首先找到 thinkphp/library/paginator/dirver/ 將底下的 Bootstrap.php 複製一份出來,並重新命名叫 BootstrapPages.php

記得 Class 也要改成 BootstrapPages

然後我們先來看一下原本簡易的分頁 HTML 樣式是怎樣 ↓

簡易樣式

接下來我們打開 Bootstrap 的元件看分頁的 className

Pages

所以我們要修改的地方有 getAvailablePageWrapper()getDisabledTextWrapper()getActivePageWrapper(),只需要加入相對應 className 即可。

接下來要在 config 底下建立一個檔案叫 paginate.php,由於我們是外掛自己的 paginate,所以要告知 ThinkPHP 改用我們的 paginate.php 裡面的設置而不是內建的 paginate 設置,內容則如下:

<?php
return [
    'type'      => 'BootstrapPages',
    'var_page'  => 'page',
    'list_rows' => 15,
];

最後我們就可以直接來看分頁的樣式成果有沒有加載上去 ↓

分頁元件

改放 extend

接下來講解另一種加載方式,個人也建議使用此方式,首先我們先將原本在 thinkphp/library/paginator/dirver/ 底下的 BootstrapPages.php 移出來放到根目錄的 extend 資料夾內,然後將命名空間修改成 bootstrap (這邊提供前幾行範例):

namespace bootstrap;

use think\Paginator;

class BootstrapPages extends Paginator
{
  ...
}

所以目前目錄結構是這樣 ↓

extend

接下來打開我們在前面建立的 config/paginate.php 檔案,然後內容改成以下:

<?php
return [
    'type'      => 'bootstrap\BootstrapPages',
    'var_page'  => 'page',
    'list_rows' => 15,
];

那麼結果也會是一樣可以正常顯示分頁元件唷 ↓

分頁元件

結尾

這一篇主要介紹了在 ThinkPHP 核心下建立一個自己的檔案的做法,但是一般來講自己額外修改的東西 or 第三方擴展都會建議放在 extend 中,最主要是不要去更動到核心程式碼,因為未來有可能核心程式碼是必須要更新的而覆蓋檔案,所以這邊才會也介紹放在 extend 的作法,當然實務上我建議以放在 extend 的為主。

本文同步發表於:https://hsiangfeng.github.io/php/20190928/142867792/


上一篇
Day26-從基礎學習 ThinkPHP-驗證碼
下一篇
Day28-從基礎學習 ThinkPHP-製作一個留言版
系列文
從基礎學習 ThinkPHP31
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言