DIV CSS 佈局教程網

動態顯示 jqGrid:初始化屬性設定與常見錯誤排查
編輯:JQuery特效代碼     

jqGrid 的屬性很多,其中幾個如果沒設對,會導致「頁面按鈕全失效」這種看不出原因的錯誤。這裡把常用屬性與動態載入的做法整理出來。

一、常用屬性

$("#id").jqGrid({
    url: "",
    datatype: "local",
    postData: { strJson: Data },
    mtype: "post",
    height: 45,
    width: 450,
    rowNum: rum,              // 每頁記錄數
    pgtext: "第{0}頁 共{1}頁",
    pgbuttons: true,          // 是否顯示分頁按鈕
    pginput: true,            // 是否允許輸入頁碼
    autoheight: true,
    rownumbers: false,        // 是否顯示行號
    scrollrows: false,        // 是否顯示行滾動條
    viewrecords: true,        // 是否顯示總記錄數
    multiselect: true,        // 是否顯示複選框
    recordpos: "left",        // 記錄數顯示位置
    sortorder: "asc",
    pager: "#Pager"
});

二、初始不載入資料時該怎麼設

如果頁面載入時還不想觸發表格初始化,必須把 url 設為空字串、datatype 設為 "local"。否則會丟出 JS 錯誤,而這個錯誤會連帶讓頁面上其他 button 全部失效——這是最難查的一個症狀。

三、需要一開始就載入時

把 url 填成實際端點。在 ASP.NET MVC 架構下格式是 "/controller/action/",開頭的斜線是必須的,少了它要求會打到錯誤的路徑而進不了 action。

設了 url 之後還有一個配對問題:datatype 必須與 postData 的資料格式一致。例如 datatype: "json",那 postData 傳的就該是 JSON 字串,兩者不匹配一樣會出錯。

四、動態觸發初始化

做法是:初始階段 url 留空、datatype 設 "local"(否則報錯),等到使用者真的需要看資料時,再用 setGridParam 補上參數並觸發。

以下範例在表格某列雙擊時載入該學生的課程資訊:

// 雙擊列事件
ondblClickRow: function () {
    courseData = JSON.stringify({
        stuNum: studentNum,
        rowNum: rum,
        page: 1
    });

    jQuery("#courseInfoGrid").jqGrid("setGridParam", {
        url: "/PersonalArrearsSettlement/GetStudentCourseInfo",  // 設定表格的 url
        datatype: "json",                                        // 設定資料型別
        postData: { strJson: courseData }
    });
}

呼叫 setGridParam 之後,jqGrid 會自動重新發出請求並重繪,不需要另外呼叫 trigger("reloadGrid");但如果 url 在初始化時就已設定、你只是想換參數重查,那就必須補上 .trigger("reloadGrid") 才會生效。

五、排查清單

  • 頁面其他按鈕集體失效 → 檢查初始化時 url 是否為空、datatype 是否為 local。
  • 請求進不了後端 action → 檢查 url 開頭是否有 /。
  • 表格空白但無錯誤 → 檢查 datatype 與回傳格式是否相符,以及回傳的 JSON 是否包含 rows 與 total 欄位。
  • 分頁頁碼顯示異常 → 確認 rowNum 與後端回傳的 records 一致。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved