後台管理系統裡最常被重複實現的功能就是分頁表格。本文以 ASP.NET MVC + Entity Framework + EasyUI 為例,把前端表格、頁面交互、控制器分頁、數據訪問四層串起來,形成一套可直接複用的模板。
<script type="text/javascript">
$(function () {
LoadGrid();
});
// 加載表格
function LoadGrid() {
$('#roleGrid').datagrid({
width: 900,
striped: true, // 隔行變色
fitColumns: true, // 防止出現水平滾動
fit: true, // 自動撐滿父容器
iconCls: "icon-save",
idField: 'RoleId', // 唯一鍵
url: "GetRoles", // 數據來源
dataType: "json",
singleSelect: true, // 只允許選一行
loadMsg: '正在加載,請稍候...',
rownumbers: false,
pagination: true, // 啟用底部分頁欄
nowrap: true, // 超出部分截斷
checkOnSelect: true, // 點擊行時同步勾選 checkbox
pageNumber: 1, // 初始頁碼
pageSize: 10, // 每頁記錄數
pageList: [5, 10, 30], // 每頁記錄數可選項
showFooter: false,
columns: [[
{ field: "RoleId", title: "角色編號", width: 60, align: "center", sortable: true },
{ field: "RoleName", title: "角色名稱", width: 100, align: "center" },
{ field: "RoleRemarks", title: "備註", width: 100, align: "center" },
{ field: "IsStatus", title: "狀態", width: 60, align: "center",
formatter: function (value, row, index) {
if (value == "0") { return "正常"; }
else if (value == "1") { return "停用"; }
}
},
{ field: "edit", title: "操作", align: "center", width: 80,
formatter: function (value, row, index) {
var detail = '<a style="padding:1px;color:black;" onclick="editRole(' + index + ')">'
+ '<i class="fa fa-edit"></i>編輯</a>';
var del = '<a style="color:black;" onclick="delRole(' + index + ')">'
+ '<i class="fa fa-trash-o"></i>刪除</a>';
var setrole = '<a style="color:black;" onclick="setRights(' + index + ')">'
+ '<i class="fa fa-exclamation-triangle"></i>設置權限</a>';
return " " + detail + " | " + del + " | " + setrole;
}
}
]]
});
}
// 編輯:以分層彈窗展示表單並回填數據
function editRole(i) {
var rows = $("#roleGrid").datagrid("getRows");
layer.open({
title: false,
type: 2,
closeBtn: false,
area: ['420px', '418px'],
skin: 'layui-layer-rim',
content: ['/Admin/ShowForm/EidtRole', 'no'],
success: function (layero, index) {
var body = layer.getChildFrame('body', index);
body.contents().find("#roleId").val(rows[i].RoleId);
body.contents().find("#roleName").val(rows[i].RoleName);
if (rows[i].RoleRemarks != "-") {
body.contents().find("#remarks").val(rows[i].RoleRemarks);
}
body.contents().find("#isstutas").val(rows[i].IsStatus);
}
});
}
// 刪除:帶二次確認
function delRole(i) {
var rows = $("#roleGrid").datagrid("getRows");
var postData = { roleId: rows[i].RoleId };
layer.confirm('確認刪除該角色?', { btn: ['確認', '取消'], shade: false }, function (index) {
$.ajax({
type: "POST",
url: "DeleRole",
data: postData,
success: function (result) {
if (result == "true") {
layer.msg("操作成功!", { icon: 6, time: 1000 }, function () {
$("#roleGrid").datagrid("reload"); // 刷新表格
layer.close(index);
});
} else if (result == "false") {
layer.msg("操作失敗!", { icon: 2 });
} else {
layer.msg("系統錯誤,請聯繫管理員!", { icon: 0 });
}
}
});
}, function (index) {
layer.close(index);
});
}
</script>
只需要一個空表格作為容器,其餘由 datagrid 渲染:
<table id="roleGrid"></table>
這是整個功能的關鍵。EasyUI 分頁要求返回對象包含兩個字段:total(總記錄數)與 rows(當前頁數據)。total 決定分頁器有多少頁,rows 決定本頁顯示什麼。
/// <summary>
/// 動態生成表格數據
/// </summary>
public JsonResult GetRoles(int? page, int? rows)
{
page = page == null ? 1 : page; // 第幾頁
rows = rows == null ? 10 : rows; // 每頁行數
List<role> rList = rService.GetAllRoles(Convert.ToInt32(page), Convert.ToInt32(rows));
List<role> roleList = new List<role>();
for (int i = 0; i < rList.Count; i++)
{
role r = new role();
r.RoleId = rList[i].RoleId;
r.RoleName = rList[i].RoleName;
// 空備註統一顯示為 "-",避免前端出現空白列
r.RoleRemarks = string.IsNullOrEmpty(rList[i].RoleRemarks) ? "-" : rList[i].RoleRemarks;
r.IsStatus = rList[i].IsStatus;
roleList.Add(r);
}
var json = new
{
total = rService.GetTotal(),
rows = roleList
};
return Json(json, JsonRequestBehavior.AllowGet);
}
注意 JsonRequestBehavior.AllowGet 不可省略,否則 MVC 會拒絕返回 JSON。另外示例中把 rows 的默認值從 1 改為 10,原寫法在缺少參數時只返回一行,容易讓人誤以為分頁壞了。
/// <summary>
/// 分頁獲取數據
/// </summary>
public List<role> GetAllRoles(int page, int rows)
{
using (diamondEntities entity = new diamondEntities())
{
IQueryable<role> query = entity.roles
.OrderBy(a => a.RoleId)
.Skip((page - 1) * rows) // 跳過前面頁的記錄
.Take(rows); // 取當前頁
List<role> list = query.ToList();
return list.Count > 0 ? list : null;
}
}
/// <summary>
/// 獲取總記錄數
/// </summary>
public int GetTotal()
{
using (diamondEntities entity = new diamondEntities())
{
return entity.roles.Count();
}
}
幾處可以更好的地方:排序必須先於 Skip,否則分頁結果順序不定,EF 甚至会拋異常;Count() 不必 ToList(),直接讓 EF 生成 SELECT COUNT(*),避免把全部數據拉到內存;返回 null 不如返回空數組,前端處理起來更一致。
把 total 與 rows 的查合併併為一次。目前是兩次數據庫往返,數據量大時可用 Skip/Take 取當前頁後,配合單獨的 Count 查詢(無法省),或緩存 total。
操作列的 index 有隱患。formatter 中把 index 拼進 onclick,翻頁後 index 會從 0 重新計數,若同時打開多頁數據容易錯位。更穩妥的做法是把 RoleId 直接寫進 onclick 參數,避免依賴行序號。
拼接 HTML 要注意轉義。若 RoleName 等字段含引號或尖括號,直接拼進 onclick 會破壞結構甚至產生 XSS,建議改用 data-* 屬性加事件委託。
刪除與編輯應加服務端校驗。前端確認框只是體驗層,後端必須再驗一次權限與數據合法性,並用 EntityState 判斷刪除是否真的影響到行。
大量數據時考慮服務端搜索。datagrid 支持 onClickCell、toolbar 定義搜索框,配合 $('#roleGrid').datagrid('load', { keyword: kw }) 把查詢條件帶到後端,是後台列表的標準做法。
把這四層模板記下來,換成用戶列表、訂單列表、商品列表時只需替換實體與字段定義,分頁、排序、彈窗編輯、確認刪除這套交互可以完整複用。