網路上的分頁外掛與開源方案不勝枚舉,但後端出身的工程師往往不熟悉 CSS 樣式,直接套用反而更花時間。其實分頁的原理相當單純:用 AJAX 把當前頁碼送到後端,後端以 limit 做資料切片,再把總頁數帶回前端渲染。本文提供兩套純 JavaScript 實作,一個走 AJAX 動態載入,一個走前端 DOM 顯示/隱藏。
先看效果:


這個專案全程以 JavaScript 撰寫,前端資料透過 AJAX 取得後再組裝字串動態插入頁面。以下是逐層拆解的實作步驟。
裡面的數值都是佔位用的假值,真正的內容會在 JS 中重新賦寫。
<ul class="page" id="page">
<li id="shouye" class="p-prev disabled">
<a href='javascript:indexpage(1);'>首 頁</a>
</li>
<li id="shangyiye" class="p-prev disabled">
<a href='javascript:indexpage(-1);'><i></i>上一頁</a>
</li>
<li><a id="one" href="javascript:void(0);">1</a></li>
<li><a id="two" href="javascript:void(0);">2</a></li>
<li><a id="three" href="javascript:void(0);">3</a></li>
<li class="more"><a id="five" href="javascript:void(0);">...</a></li>
<li><a id="fore" href="javascript:void(0);">13855</a></li>
<li class='p-next'>
<a href='javascript:indexpage(-3);'
onclick="jumpToPage('2','/goods/ajaxqueryGoodsList.do.html','',
'goodsListContainer','13855', listPageCallback);">
下一頁<i></i>
</a>
</li>
<li id="weiye" class='p-next'>
<a href='javascript:void(0);' onclick="indexpage(0);">尾 頁</a>
</li>
<li class="total">
<span id="span_number">
共13855頁 到第
<input type="text" id="input_number" class="page-txtbox" />頁
<input name="" value="確定" type="button"
onclick="jumpToPage(jQuery('#input_number').val(),
'/goods/ajaxqueryGoodsList.do.html','',
'goodsListContainer','13855', listPageCallback);"
class="page-btn"/>
</span>
</li>
</ul>
一個存當前頁、一個存總頁數。總頁數在頁面載入完成、後端查詢回來後直接寫入;當前頁則在每次操作後更新。
<input id="jiazai" type="hidden"></input><!-- 當前頁碼 --> <input id="totalpage" type="hidden"></input><!-- 總頁碼 -->
$(function(){
$('#jiazai').val(1); // 預設停在第一頁
ajaxfunction(page, arg, chipssort, ''); // 呼叫抽取出來的 AJAX 方法
});
因為同一頁會多次用到這段邏輯,抽出來後維護成本大幅降低。後端回傳的是一個 List 集合。
// 抽取的 AJAX 方法
function ajaxfunction(page, arg, chipssort, fontval){
$.ajax({
type: 'POST',
url: '/admin/receptionchips/showlist',
data: {
page: page,
sort: arg,
chipssort: chipssort,
fontval: fontval
},
dataType: 'json',
contentType: 'application/x-www-form-urlencoded; charset=utf-8',
success: function(data){
// 交給負責組裝的方法處理
commonfunction(data);
}
});
}
這是分頁的核心:先從回傳資料取出總頁數寫入隱藏域,再依當前頁決定「1 2 3 4 5」這幾格要顯示哪些數字、哪些要隱藏,最後設定高亮並把頁面捲回頂端。
// 抽取的組字串方法
function commonfunction(data){
$('#projectlist').find("li").remove();
for (var i = 0; i < data.length; i++) {
/* 此頁面為動態載入,這裡負責組字串,因篇幅關係省略 */
}
// ===== 分頁核心 =====
if (data.length > 0) {
var pading = data[0].padingnum; // 總頁數
$('#totalpage').val(pading);
var page = $('#jiazai').val(); // 當前頁
$('#countpage').html("<b id='currentPageNo'>" + page + "</b>/" + pading);
$('#span_number').html("共" + pading + "頁 到第" +
"<input type='text' id='input_number' class='page-txtbox' />頁" +
"<input name='' value='確定' type='button' onclick='indexpage(-2)'" +
" class='page-btn'/>");
} else {
$('#countpage').html("<b id='currentPageNo'>0</b>/0");
}
var pading = data[0].padingnum; // 總頁數
var nowpage = $('#jiazai').val(); // 當前頁
// 頁碼格:one two three five fore
// 下面這段看起來繁瑣,其實每格邏輯一致,只是多加了邊界判斷
if (nowpage < 5) {
$('#one').text(1);
$('#one').attr('href', 'javascript:pagenum("1");');
$('#two').text(2);
$('#two').attr('href', 'javascript:pagenum("2");');
$('#three').text(3);
$('#three').attr('href', 'javascript:pagenum("3");');
$('#five').text(4);
$('#five').attr('href', 'javascript:pagenum("4");');
$('#fore').text(5);
$('#fore').attr('href', 'javascript:pagenum("5");');
$('#five').parent().show();
$('#fore').parent().show();
} else {
// 讓中間那格固定停在當前頁
$('#one').text(Number(nowpage) - 2);
$('#one').attr('href', 'javascript:indexpage("' + (Number(nowpage) - 2) + '");');
$('#two').text(Number(nowpage) - 1);
$('#two').attr('href', 'javascript:indexpage("' + (Number(nowpage) - 1) + '");');
$('#three').text(nowpage);
$('#three').attr('href', 'javascript:indexpage("' + nowpage + '");');
$('#five').parent().show();
$('#fore').parent().show();
// 判斷往後第一格是否超出總頁數
if (Number(nowpage) + 1 > pading) {
$('#five').parent().hide();
$('#fore').parent().hide();
} else {
$('#five').parent().show();
$('#five').text(Number(nowpage) + 1);
$('#five').attr('href', 'javascript:indexpage("' + (Number(nowpage) + 1) + '");');
}
// 判斷往後第二格是否超出總頁數
if (Number(nowpage) + 2 > pading) {
$('#fore').parent().hide();
} else {
$('#fore').parent().show();
$('#fore').text(Number(nowpage) + 2);
$('#fore').attr('href', 'javascript:indexpage("' + (Number(nowpage) + 2) + '");');
}
}
// 總頁數少於 5 時,控制各格的顯示與隱藏
if (pading == 0) {
$('#one').parent().hide();
$('#two').parent().hide();
$('#three').parent().hide();
$('#five').parent().hide();
$('#fore').parent().hide();
} else if (pading == 1) {
$('#shouye').hide();
$('#weiye').hide();
$('#one').parent().hide();
$('#two').parent().hide();
$('#three').parent().hide();
$('#five').parent().hide();
$('#fore').parent().hide();
} else if (pading == 2) {
$('#one').parent().show();
$('#two').parent().show();
$('#three').parent().hide();
$('#five').parent().hide();
$('#fore').parent().hide();
} else if (pading == 3) {
$('#one').parent().show();
$('#two').parent().show();
$('#three').parent().show();
$('#five').parent().hide();
$('#fore').parent().hide();
} else if (pading == 4) {
$('#one').parent().show();
$('#two').parent().show();
$('#three').parent().show();
$('#five').parent().show();
$('#fore').parent().hide();
} else {
$('#one').parent().show();
$('#two').parent().show();
$('#three').parent().show();
$('#five').parent().show();
$('#fore').parent().show();
}
// 設定高亮:當前頁對應的格子加上 current
$('#page a').each(function() {
$(this).parent().removeClass("current");
if ($(this).text() == nowpage) {
$(this).parent().addClass("current");
}
});
// 回到頁面頂端
$("html,body").animate({scrollTop: 0}, 500);
// 當前頁碼加一,供下次請求使用
$('#jiazai').val(Number(nowpage) + Number(1));
}
只要能把總頁數正確取回、首頁/下一頁等按鈕傳值正確,分頁基本就不會出問題;AJAX 的請求位址與回傳結構則依各自後端調整。
若資料已經全部在頁面上(例如一張 table),就不必走後端,直接用 JavaScript 控制每一列的 display 即可。
function goPage(pno, psize){
var itable = document.getElementById("idData");
var num = itable.rows.length; // 表格行數
var totalPage = 0; // 總頁數
var pageSize = psize; // 每頁顯示行數
if ((num-1)/pageSize > parseInt((num-1)/pageSize)) {
totalPage = parseInt((num-1)/pageSize) + 1;
} else {
totalPage = parseInt((num-1)/pageSize);
}
var currentPage = pno; // 當前頁
var startRow = (currentPage - 1) * pageSize + 1; // 起始列
var endRow = currentPage * pageSize + 1; // 結束列
endRow = (endRow > num) ? num : endRow;
// 前三列(例如表頭)永遠顯示
for (i = 0; i < 1; i++) {
var irow = itable.rows[i];
irow.style.display = "block";
}
for (var i = 1; i < num; i++) {
var irow = itable.rows[i];
if (i >= startRow && i < endRow) {
irow.style.display = "block";
} else {
irow.style.display = "none";
}
}
// 組出下方的分頁導覽列
var tempStr = "";
if (currentPage > 1) {
tempStr += "<a href='#' onClick='goPage(" + (currentPage-1) + "," + psize + ")'>" +
"<img src='images/back_buttom01.jpg' width='38' height='15' border='0' /></a> ";
} else {
tempStr += "<a href='#'>" +
"<img src='images/back_buttom01.jpg' width='38' height='15' border='0' /></a> ";
}
for (var i = 1; i <= totalPage; i++) {
if (i == currentPage) {
tempStr += i + " ";
} else {
tempStr += "<a href='#' onClick='goPage(" + i + "," + psize + ")'>" + i + "</a> ";
}
}
if (currentPage < totalPage) {
tempStr += "<a href='#' onClick='goPage(" + (currentPage+1) + "," + psize + ")'>" +
"<img src='images/next_buttom01.jpg' width='38' height='15' border='0' /></a> ";
} else {
tempStr += "<a href='#'>" +
"<img src='images/next_buttom01.jpg' width='38' height='15' border='0' /></a> ";
}
tempStr += "<a href='#top'>" +
"<img src='images/top_buttom01.jpg' width='38' height='15' border='0' /></a>";
document.getElementById("barcon").innerHTML = tempStr;
}
window.onload = function(){
goPage(1, 10);
};
導覽列只需預留一個容器:
<div id="barcon" name="barcon"></div>
方法一適合資料量大、需要伺服器端切片或排序的情境,每次翻頁都是一次真正的請求;方法二適合資料量小、已一次載入的表格,翻頁純粹是前端顯示切換,沒有網路延遲。兩者的分頁「語意」相同,差別只在資料來源。
小提醒:範例中的上一頁/下一頁圖片可依自身設計替換。逐行讀懂再加上自己的註解,這套邏輯其實半小時內就能完全掌握。