DIV CSS 佈局教程網

Bootstrap Paginator 搭配 Ajax 實作無刷新分頁
編輯:關於JavaScript     

要解決的問題

傳統分頁靠網址參數,每翻一頁整頁重載。若資料是透過 Ajax 取得的,翻頁時也希望不重新載入頁面,就需要把「分頁控制項」與「資料請求」綁在一起:點頁碼 → 抓該頁資料 → 更新列表與頁碼狀態。

頁面結構

先在需要分頁的位置放一個空的 ul,頁碼由插件動態生成:

 <ul class="pagination" id="pageUl"></ul>

分頁函數

 function paging(page) {

  // 抓當前頁的資料
  $.ajax({
    type: "GET",
    url: "${ctx}/api/v1/user/1/" + (page - 1) + "/5",
    dataType: "json",
    success: function (msg) {
      // 省略:將 msg 渲染成列表
    }
  });

  // 抓總筆數,用來算總頁數
  $.ajax({
    type: "GET",
    url: "${ctx}/api/v1/user/count/1",
    dataType: "json",
    success: function (msg) {
      var pages = Math.ceil(msg.data / 5);   // 每頁 5 筆
      var element = $('#pageUl');

      var options = {
        bootstrapMajorVersion: 3,
        currentPage: page,      // 當前頁
        numberOfPages: 5,       // 頁碼區顯示幾個按鈕
        totalPages: pages       // 總頁數
      };

      element.bootstrapPaginator(options);
    }
  });
}

注意 (page - 1) + "/5" 這段:頁碼從 1 起算,而後端 offset 從 0 起算,兩者相差一,轉換時最容易出錯。

核心:改寫 onPageClicked

插件預設只負責畫頁碼,點擊後要做什麼得自己接。修改 bootstrap-paginator.js 中的回呼:

 onPageClicked: function (event, originalEvent, type, page) {
  var currentTarget = $(event.currentTarget);

  switch (type) {
    case "first":
      currentTarget.bootstrapPaginator("showFirst");
      paging(page);
      break;
    case "prev":
      currentTarget.bootstrapPaginator("showPrevious");
      paging(page);
      break;
    case "next":
      currentTarget.bootstrapPaginator("showNext");
      paging(page);
      break;
    case "last":
      currentTarget.bootstrapPaginator("showLast");
      paging(page);
      break;
    case "page":
      currentTarget.bootstrapPaginator("show", page);
      paging(page);
      break;
  }
}

寫法很單純:type 指出使用者點的是首頁、上一頁、下一頁、末頁還是哪個頁碼,先讓插件更新視覺狀態,再呼叫 paging(page) 去抓資料。page 這個參數插件已經算好並傳進來了,直接轉傳即可,不必自己推算。

效果如下:

幾個實務上的建議

不要直接改插件原始檔。範例是直接在 bootstrap-paginator.js 裡動手,這在教學上最直觀,但專案裡一旦升級或多人協作,改動就會被覆蓋或遺漏。較好的做法是把 onPageClicked 當作 options 傳進初始化呼叫,例如 element.bootstrapPaginator($.extend(options, { onPageClicked: myHandler })),讓自訂邏輯留在自己的檔案裡。

兩次請求可以合併。總筆數在翻頁之間幾乎不變,沒必要每頁都打一次。第一次載入時取一次並快取,後續只抓當前頁資料即可,能少一半請求。

記得處理載入中與失敗狀態。Ajax 往返期間若不顯示提示,使用者容易重複點擊造成請求疊加;失敗時也應給出可重試的路徑,而不是讓列表停在舊資料上無聲無息。

每次刷新都重建頁碼。範例在每次 success 裡重新呼叫 bootstrapPaginator,這會重建整個 DOM。資料量大或點擊頻繁時,可考慮只更新 active 狀態而非整組重畫。

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