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