DIV CSS 佈局教程網

pagination:jQuery 分頁外掛的完整參數指南
編輯:JavaScript綜合知識     

pagination.js 是早期相當常見的客戶端分頁外掛。它的運作方式是:一次把全部資料(JSON)載入前端,再由外掛切出目前這一頁要顯示的部分,並透過 callback 讓你去決定「換頁時要做什麼」。

三步行啟用

<link rel="stylesheet" href="pagination.css">
<script type="text/javascript" src="jquery.min.js"></script>
<script type="text/javascript" src="jquery.pagination.js"></script>

<div class="pagination"></div>

<script>
function pageselectCallback(page_index, jq) {
  alert(page_index);
  return false;          // 回傳 false 阻止預設行為
}

$(document).ready(function () {
  $(".pagination").pagination(100, {      // 100 = 總筆數
    callback: pageselectCallback,
    num_edge_entries: 1
  });
});
</script>

第一個參數是總記錄數,外掛用它配合每頁筆數算出總頁數。

參數完整對照

參數說明預設值
callback點擊頁碼時的回呼函式function(){return false;}
current_page初始選中的頁碼0
items_per_page每頁顯示幾筆10
link_to分頁連結的 href#
num_display_entries最多顯示幾個頁碼11
next_text「下一頁」的文字Next
next_show_always設為 false 時,只有還能往後翻才顯示true
prev_text「上一頁」的文字Previous
prev_show_always設為 false 時,只有還能往前翻才顯示true
num_edge_entries設為 1 則永遠顯示首頁與末頁0
ellipse_text省略區間的標示字串…
load_first_page設為 true 時,初始化就會觸發 callbacktrue

這個外掛最大的限制

資料是一次性全部讀進瀏覽器的。筆數少時沒問題,但幾千筆以上就會造成明顯的初次載入延遲,而且把全部資料送到前端本身也有資安疑慮——不想讓使用者看到的內容,就不該出現在前端。

它的 callback 設計其實已經預留了接後端的空間:在 callback 裡發 AJAX 請求,只取目前頁的資料回來渲染即可。真正的分頁應該永遠是伺服器端的,用 LIMIT ... OFFSET ... 或 cursor-based 查詢,搭配 fetch 更新畫面。

現代替代方案

不需要外掛也能做出完整分頁。核心就是算頁碼:

function renderPager(total, page, perPage) {
  var pages = Math.ceil(total / perPage);
  var html = '';
  for (var i = 1; i <= pages; i++) {
    html += '<button type="button" data-page="' + i + '"' +
            (i === page ? ' aria-current="page" disabled' : '') + '>' + i + '</button>';
  }
  return html;
}

記得標示 aria-current="page" 讓輔具知道目前位置,並用 <nav aria-label="分頁導覽"> 包住整組按鈕。資料量真的很大時,改用無限捲動或「載入更多」按鈕,通常比翻頁更符合行動裝置的使用習慣。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved