## 分頁 MixPHP 的分頁類采用的一種非常靈活的設計方式，分頁的構建都由視圖層完成，可以構建任意結構的分頁式樣。 | 類 | 調用 | | --- | --- | | Mix\Pagination\Paginator | new Paginator([配置]); | ## 安裝 ``` composer require mix/pagination ``` >[danger] 該類默認代碼未包含， 需自行安裝。 ## 模型范例 MixPHP 建議用戶在模型中使用分頁類，因為在模型內更加方便獲取分頁數據，分頁數據可隨分頁對象由控制器傳遞至視圖。 ~~~ // 模型內的方法 public function getPaginator($page) { return new Paginator([ // 數據結果集 'items' => $data, // 數據總行數 'count' => 987, // 當前頁，值 >= 1 'page' => $page, // 每頁顯示數量 'perPage' => 10, // 固定最小最大頁碼 'fixedMinMax' => true, // 鏈接數量 'links' => 5, ]); } ~~~ ## 視圖范例 我們設計了三個常用的分頁式樣，使用 bootstrap 的用戶可直接復制代碼使用，使用其他前端框架的用戶只需修改相關的 HTML 即可。 ### 1. 帶上下頁且固定最小最大頁  ~~~ <?php if ($paginator->display()): ?> <nav aria-label="Page navigation"> <ul class="pagination"> <?php if ($paginator->hasPrev()): ?> <li><a href="/?page=<?= $paginator->prev(); ?>">上一頁</a></li> <?php else: ?> <li class="disabled"><span>上一頁</span></a></li> <?php endif; ?> <?php foreach ($paginator->numbers() as $number): ?> <?php if ($number->text == 'ellipsis'): ?> <li class="disabled"><span>...</span></li> <?php else: ?> <li <?= $number->selected ? 'class="active"' : ''; ?>><a href="/?page=<?= $number->text; ?>"><?= $number->text; ?></a></li> <?php endif; ?> <?php endforeach; ?> <?php if ($paginator->hasNext()): ?> <li><a href="/?page=<?= $paginator->next(); ?>">下一頁</a></li> <?php else: ?> <li class="disabled"><span>下一頁</span></a></li> <?php endif; ?> </ul> </nav> <p><?php echo "當前第 ", $paginator->page, " 頁，共 ", $paginator->pages, " 頁"; ?></p> <?php endif; ?> ~~~ ### 2. 純數字固定最小最大頁  ~~~ <?php if ($paginator->display()): ?> <nav aria-label="Page navigation"> <ul class="pagination"> <?php foreach ($paginator->numbers() as $number): ?> <?php if ($number->text == 'ellipsis'): ?> <li class="disabled"><span>...</span></li> <?php else: ?> <li <?= $number->selected ? 'class="active"' : ''; ?>><a href="/?page=<?= $number->text; ?>"><?= $number->text; ?></a></li> <?php endif; ?> <?php endforeach; ?> </ul> </nav> <p><?php echo "當前第 ", $paginator->page, " 頁，共 ", $paginator->pages, " 頁"; ?></p> <?php endif; ?> ~~~ ### 3. 帶首尾頁上下頁  ~~~ <?php if ($paginator->display()): ?> <nav aria-label="Page navigation"> <ul class="pagination"> <?php if ($paginator->hasFirst()): ?> <li><a href="/">首頁</a></li> <?php else: ?> <li class="disabled"><span>首頁</span></a></li> <?php endif; ?> <?php if ($paginator->hasPrev()): ?> <li><a href="/?page=<?= $paginator->prev(); ?>">上一頁</a></li> <?php else: ?> <li class="disabled"><span>上一頁</span></a></li> <?php endif; ?> <?php foreach ($paginator->numbers() as $number): ?> <li <?= $number->selected ? 'class="active"' : ''; ?>><a href="/?page=<?= $number->text; ?>"><?= $number->text; ?></a></li> <?php endforeach; ?> <?php if ($paginator->hasNext()): ?> <li><a href="/?page=<?= $paginator->next(); ?>">下一頁</a></li> <?php else: ?> <li class="disabled"><span>下一頁</span></a></li> <?php endif; ?> <?php if ($paginator->hasLast()): ?> <li><a href="/?page=<?= $paginator->totalPages; ?>">尾頁</a></li> <?php else: ?> <li class="disabled"><span>尾頁</span></a></li> <?php endif; ?> </ul> </nav> <p><?php echo "當前第 ", $paginator->page, " 頁，共 ", $paginator->pages, " 頁"; ?></p> <?php endif; ?> ~~~