萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 分頁類完整實作:智慧頁碼顯示、Bootstrap 風格、可配置參數

前言

分頁是列表頁核心元件。本文提供一個靜態方法 Page::getPageHtml(),支援:

  • 當前頁、總頁數、跳轉 URL 自動組裝
  • 最多顯示頁碼數(預設 5),當前頁置中、邊界自動調整
  • 首頁/末頁、上一頁/下一頁、當前頁高亮
  • 輸出 Bootstrap 相容 <ul class="pagination"> 結構

完整程式碼

class Page {
    /**
     * 取得分頁 HTML
     * @param int    $page  當前頁 (從 1 開始)
     * @param int    $pages 總頁數
     * @param string $url   基礎 URL,頁碼以 &page=x 附加
     * @return string HTML 字串
     */
    public static function getPageHtml($page, $pages, $url) {
        $_pageNum = 5;  // 最多顯示頁碼數

        // 邊界修正
        $page  = $page < 1 ? 1 : $page;
        $page  = $page > $pages ? $pages : $page;
        $pages = $pages < $page ? $page : $pages;

        // 計算起始/結束頁
        $_start = $page - floor($_pageNum / 2);
        $_start = $_start < 1 ? 1 : $_start;
        $_end   = $page + floor($_pageNum / 2);
        $_end   = $_end > $pages ? $pages : $_end;

        // 當顯示頁數不足時,左右擴展
        $_curPageNum = $_end - $_start + 1;
        if ($_curPageNum < $_pageNum && $_start > 1) {
            $_start -= ($_pageNum - $_curPageNum);
            $_start = $_start < 1 ? 1 : $_start;
            $_curPageNum = $_end - $_start + 1;
        }
        if ($_curPageNum < $_pageNum && $_end < $pages) {
            $_end += ($_pageNum - $_curPageNum);
            $_end = $_end > $pages ? $pages : $_end;
        }

        // 組裝 HTML
        $_pageHtml = '
    '; // 上一頁 if ($page > 1) { $_pageHtml .= '
  • «
  • '; } // 頁碼 for ($i = $_start; $i <= $_end; $i++) { if ($i == $page) { $_pageHtml .= '
  • ' . $i . '
  • '; } else { $_pageHtml .= '
  • ' . $i . '
  • '; } } // 下一頁 if ($page < $_end) { $_pageHtml .= '
  • »
  • '; } $_pageHtml .= '
'; echo $_pageHtml; } } // 使用範例 Page::getPageHtml(3, 20, 'https://example.com/list?cat=5');

輸出結構範例 (當前第 3 頁,共 20 頁)

<ul class="pagination">
  <li><a title="上一頁" href="https://example.com/list?cat=5&page=2">«</a></li>
  <li><a href="https://example.com/list?cat=5&page=1">1</a></li>
  <li><a href="https://example.com/list?cat=5&page=2">2</a></li>
  <li class="active"><a>3</a></li>
  <li><a href="https://example.com/list?cat=5&page=4">4</a></li>
  <li><a href="https://example.com/list?cat=5&page=5">5</a></li>
  <li><a title="下一頁" href="https://example.com/list?cat=5&page=4">»</a></li>
</ul>

效果圖

分頁效果圖

擴充建議

  • 加入 $pageNum 參數讓呼叫端決定顯示幾個頁碼。
  • 支援 first/last 首尾頁連結(註解部分已預留)。
  • 整合 LengthAwarePaginator (Laravel) 或 Paginator (ThinkPHP) 直接輸出。
  • 加入 rel="prev/next" SEO 標籤。
  • 前端改用 AJAX 無限滾動或 Load More 時,後端只需回傳 JSON 片段。
copyright © 萬盛學電腦網 all rights reserved