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") 才會生效。
/。rows 與 total 欄位。rowNum 與後端回傳的 records 一致。