近期在做的 ASP.NET MVC 專案需要為列表加上分頁。由於後台本來就基於 Bootstrap 開發,與其自己刻一套分頁邏輯,不如直接找現成插件,視覺風格也能保持一致。最後選用了 Bootstrap Paginator。
先下載插件,並在視圖中引入三個檔案:Bootstrap 的 CSS、jQuery(建議 1.8 以上版本)以及 Paginator 的 JS。
<link href="css/bootstrap.css" rel="stylesheet"> <script type="text/javascript" src="js/jquery-1.8.1.js"></script> <script type="text/javascript" src="js/bootstrap-paginator.js"></script>
主體只需要兩個容器:一個放資料列表,一個放分頁導航。
<div class="span9">
<label>部門列表</label>
<hr />
<div id="list"></div>
<div id="example"></div>
</div>
分頁真正的價值在於搭配 AJAX 做局部刷新。下面的範例把「取得資料」與「渲染表格」抽成函式,點擊頁碼時重複呼叫,避免整段程式碼複製兩遍:
<script>
$(function () {
var carId = 1;
// 把資料渲染到列表容器的 reusable 函式
function renderList(data) {
$("#list").empty();
$.each(data.list, function (index, item) {
var html = '<table id="data_table" class="table table-striped">'
+ '<thead><tr><th>Id</th><th>部門名稱</th>'
+ '<th>備註</th><th></th></tr></thead><tbody><tr>'
+ '<td>' + item.Id + '</td>'
+ '<td>' + item.Name + '</td>'
+ '<td>備註</td><td>'
+ '<button class="btn btn-warning" onclick="Edit(' + item.Id + ')">修改</button> '
+ '<button class="btn btn-warning" onclick="Del(' + item.Id + ')">刪除</button>'
+ '</td></tr></tbody></table>';
$("#list").append(html);
});
}
$.ajax({
url: "/OA/Setting/GetDate",
datatype: 'json',
type: "Post",
data: "id=" + carId,
success: function (data) {
if (data == null) return;
var obj = eval("(" + data + ")");
renderList(obj);
var options = {
bootstrapMajorVersion: 2,
currentPage: obj.CurrentPage, // 當前頁
totalPages: obj.pageCount, // 總頁數
itemTexts: function (type, page, current) {
switch (type) {
case "first": return "首頁";
case "prev": return "上一頁";
case "next": return "下一頁";
case "last": return "末頁";
case "page": return page;
}
},
onPageClicked: function (event, originalEvent, type, page) {
$.ajax({
url: "/OA/Setting/GetDate?id=" + page,
type: "Post",
data: "page=" + page,
success: function (data1) {
if (data1 != null) {
renderList(eval("(" + data1 + ")"));
}
}
});
}
};
$('#example').bootstrapPaginator(options);
}
});
})
</script>
後端依頁碼取出對應資料,計算總頁數後打包成 JSON 回傳:
public ActionResult GetDate(int id, int? page) {
int pageIndex = page ?? 1; // 當前頁
const int pageSize = 2; // 每頁筆數,建議移到 web.config 統一管理
// 取得需要顯示的部門資料
IEnumerable<MODEL.qgoa_department> list =
OperateContext.Current.BLLSession.Iqgoa_departmentBLL
.GetPagedList(pageIndex, pageSize, x => x.Id != null, x => x.Id);
int rowCount = list.Count();
// 計算總頁數,不足一頁者仍算一頁
rowCount = (rowCount % pageSize != 0) ? rowCount / pageSize + 1 : rowCount / pageSize;
var strResult = "{\"pageCount\":" + rowCount
+ ",\"CurrentPage\":" + pageIndex
+ ",\"list\":" + JsonConvert.SerializeObject(list) + "}";
return Json(strResult, JsonRequestBehavior.AllowGet);
}
完成後的畫面大致如下:

這個版本仍有改進空間:pageSize 寫死在程式碼裡,建議改讀 web.config 以便全域調整;頁碼、當前頁、資料筆數這些分頁屬性,如果專案規模較大,值得抽成一個獨立的分頁類別來存放,後續維護與替換分頁 UI 時都會輕名校。