DIV CSS 佈局教程網

MVC + EF + EasyUI:DataGrid 動態分頁表格的完整實作
編輯:JQuery入門技巧     

後台管理系統裡最常被重複實現的功能就是分頁表格。本文以 ASP.NET MVC + Entity Framework + EasyUI 為例,把前端表格、頁面交互、控制器分頁、數據訪問四層串起來,形成一套可直接複用的模板。

一、前端 JavaScript

<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 "&nbsp;&nbsp;" + detail + "&nbsp;|&nbsp;" + del + "&nbsp;|&nbsp;" + 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>

二、HTML 部分

只需要一個空表格作為容器,其餘由 datagrid 渲染:

<table id="roleGrid"></table>

三、控制器:返回符合 EasyUI 約定的 JSON

這是整個功能的關鍵。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,原寫法在缺少參數時只返回一行,容易讓人誤以為分頁壞了。

四、數據訪問層:EF 的 Skip/Take 分頁

/// <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 }) 把查詢條件帶到後端,是後台列表的標準做法。

把這四層模板記下來,換成用戶列表、訂單列表、商品列表時只需替換實體與字段定義,分頁、排序、彈窗編輯、確認刪除這套交互可以完整複用。

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