萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 分頁插件 pagination.js:AJAX 動態數據分頁完整實戰

插件特點

  • 基於 jQuery,零依賴
  • 支援 callback 回調獲取動態數據(AJAX)
  • 豐富參數:顯示頁碼數、邊緣頁碼、上下頁文字、橢圓號、首頁加載等
  • 輕量、易樣式化

引入資源

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

HTML 容器

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

JS 初始化與回調

function pageselectCallback(page_index, jq) {
  // page_index 從 0 開始
  // 這裡發起 AJAX 請求獲取第 page_index+1 頁數據
  $.getJSON('/api/list?page=' + (page_index + 1), function(data) {
    renderList(data.items); // 渲染列表
  });
  return false; // 阻止默認跳轉
}

$(document).ready(function() {
  $('.pagination').pagination(100, { // 總記錄數 100
    callback: pageselectCallback,
    num_edge_entries: 1,        // 永遠顯示首尾頁
    items_per_page: 10,         // 每頁條數
    num_display_entries: 11,    // 最多顯示頁碼數
    next_text: '下一頁',
    prev_text: '上一頁',
    ellipse_text: '...',
    link_to: '#',
    prev_show_always: true,
    next_show_always: true,
    load_first_page: true       // 初始化時觸發 callback
  });
});

參數對照表

參數說明默認值
callback點擊分頁回調函數function(){return false;}
current_page初始化選中頁碼(0基)0
items_per_page每頁記錄數10
num_display_entries最多顯示頁碼數11
num_edge_entries邊緣頁碼數(1=永遠顯示首尾)0
ellipse_text省略號文字…
next_text / prev_text上下頁文字Next / Previous
load_first_page初始化是否觸發回調true

進階:JSON 數據預加載優化

原文提到一次性讀取所有 JSON 到 JS 文件再分頁,效率較低。實戰建議:

  1. 服務端分頁:API 接受 page/size 參數,僅返回當前頁數據。
  2. 前端緩存:首次請求後緩存到 sessionStorage,二次訪問秒出。
  3. 虛擬滾動:數據量極大時改用無限滾動或虛擬列表。
copyright © 萬盛學電腦網 all rights reserved