萬盛學電腦網

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

PHP 分頁工具類:兩種實現邏輯深度解析

引言

分頁是 Web 應用中最常見的功能之一。本文介紹一個 PHP 分頁工具類,提供兩種不同的頁碼顯示算法:「滑動尺子法」與「分段處理法」,並附帶完整代碼與示例圖。

核心思路:滑動尺子法(_getShowPageNumber)

將總頁數視為一塊固定長度的木塊,顯示頁碼數(_totalShowPages)為一把可滑動的尺子。目標是找到尺子在木塊上的起始($start)與結束($end)位置。

  1. 若尺子長度 ≥ 木塊長度,直接輸出所有頁碼。
  2. 否則根據當前頁(_curPage)計算 $start、$end,確保尺子不超出邊界。
  3. 輸出首頁、省略號、中間頁碼、尾頁等元素。

代碼實現

protected function _getShowPageNumber() {
    $pageHtml = '';
    // 計算起始點
    if ($this->_curPage - 2 > 1) {
        $start = $this->_curPage - 2;
    } else {
        $start = 1;
    }
    // 計算結束點
    $end = $start + $this->_totalShowPages;
    if ($end >= $this->_totalPages) {
        $end = $this->_totalPages;
        $start = $end - $this->_totalShowPages;
    }
    // 首頁與前省略號
    if ($start != 1) {
        $pageHtml .= $this->_getPageHtml(1);
        $preMore = $this->_curPage - $this->_totalShowPages;
        if ($preMore < 1) $preMore = 1;
        $pageHtml .= $this->_getMorePageHtml($preMore);
    }
    // 中間頁碼
    for ($page = $start; $page < $end; $page++) {
        $pageHtml .= $this->_getPageHtml($page);
    }
    // 後省略號與尾頁
    if ($end != $this->_totalPages) {
        $pageHtml .= $this->_getMorePageHtml($end);
    }
    $pageHtml .= $this->_getNormalPageHtml($this->_totalPages);
    return $pageHtml;
}

備選實現:分段處理法(_getShowPageNumberTwo)

根據當前頁與總顯示頁數的關係,分四種情況處理:

  • 當前頁在前段:輸出前 N 頁 + 省略號 + 尾頁
  • 當前頁在中段:首頁 + 省略號 + 當前頁前後頁碼 + 省略號 + 尾頁
  • 當前頁在後段:首頁 + 省略號 + 後 N 頁
  • 邊界情況特殊處理
protected function _getShowPageNumberTwo() {
    if ($this->_curPage < $this->_totalShowPages) {
        for ($page = 1; $page < $this->_totalShowPages; $page++) {
            $pageHtml .= $this->_getPageHtml($page);
        }
        $pageHtml .= $this->_getMorePageHtml($this->_totalShowPages);
        $pageHtml .= $this->_getNormalPageHtml($this->_totalPages);
    } else {
        $pageHtml .= $this->_getNormalPageHtml(1);
        if ($this->_curPage == $this->_totalShowPages) {
            $pageHtml .= $this->_getMorePageHtml(1);
        } else {
            $pageHtml .= $this->_getMorePageHtml($this->_curPage - $this->_totalShowPages);
        }
        if ($this->_curPage + $this->_totalShowPages >= $this->_totalPages) {
            for ($page = $this->_totalPages - $this->_totalShowPages; $page <= $this->_totalPages; $page++) {
                $pageHtml .= $this->_getPageHtml($page);
            }
        } else {
            $start = $this->_curPage - 2;
            $end = $this->_curPage + $this->_totalShowPages - 2;
            for ($page = $start; $page < $end; $page++) {
                $pageHtml .= $this->_getPageHtml($page);
            }
            $pageHtml .= $this->_getMorePageHtml($this->_curPage + $this->_totalShowPages - 2);
            $pageHtml .= $this->_getNormalPageHtml($this->_totalPages);
        }
    }
    return $pageHtml;
}

效果展示

分頁效果1 分頁效果2 分頁效果3

總結

兩種算法各有優勢:滑動尺子法邏輯清晰、代碼簡潔;分段處理法邊界控制更細緻。實際項目中可根據 UI 需求選擇或結合優化。

copyright © 萬盛學電腦網 all rights reserved