jqGrid 官方文件:https://www.trirand.com/jqgridwiki/doku.php?id=wiki:jqgriddocs
jqGrid Demo:https://trirand.com/blog/jqgrid/jqgrid.html#t107
基礎用法到處都有教學,這裡直接跳到實戰。先來看成果:

這個 Demo 做到了查詢、修改、分組;新增與刪除等基本功能在官方 Demo 裡都能找到對應範例。
第一次載入本年度的經營計劃資料,載入完成後立刻把 jqGrid 切換成本地資料模式(datatype: 'local'),如此一來分頁與查詢都在前端完成,不必反覆打伺服器。
接著是修改規則:只允許編輯「本月以後」的計劃。判斷放在 afterShowForm 與 afterclickPgButtons 兩個環節——若時間小於或等於本月,就把提交按鈕設為 disabled,否則開放。還有一個容易忽略的細節:提交到伺服器前,必須把 datatype 改回 json,否則根本不會發出請求。
本 Demo 只做了 2010、2011、2012 三個靜態資料源,修改時僅回傳訊息,並未真正改動資料。
<table id="jqgridlist"> </table> <div id="pager"> </div>
jQuery("#jqgridlist").jqGrid({ url: 'DataHandler.ashx',
datatype: function (pdata) {
$.ajax({ url: 'DataHandler.ashx',
dataType: "json", type: "post",
contentType: "application/x-www-form-urlencoded; charset=utf-8",
data: pdata,
error: function (data, status, statusText) {
if (!(status == 200 && statusText == "parsererror"))
alert("客服端解析數據錯誤!\n請與管理員聯系");
else
alert"請求服務器錯誤!\n請稍後再試或與管理員聯系");
},
complete: function (jsondata, stat) {
if (stat == "success") {
var thegrid = jQuery("#jqgridlist")[0],
data = eval("(" + jsondata.responseText + ")");
thegrid.addJSONData(data);
data = null;
jsondata = null;
}
}
});
},
colNames: ["行號", "日期期間", "c_code", "單位名稱", "銷售回款", "營業收入", "工業總產值", "利潤總額", "上交稅金"],
colModel: [{ name: "ROWNUM", index: "ROWNUM", editable: false, summaryType: 'count',
summaryTpl: '({0}) total'
},
{ name: "JHQJ", index: "JHQJ", editable: true, stype: 'text', search: true, searchoptions: { sopt: ['eq'] },
editoptions: { style: "border:0; background-color:transparent;" }
},
{ name: "C_CODE", index: "C_CODE", sortable: false, editable: true, search: false, hidden: true,
editrules: { edithidden: false }, editoptions: { style: "border:0; background-color:transparent;" }
},
{ name: "DWJC", index: "DWJC", editable: true, search: true, stype: 'text', searchoptions: { sopt: ['cn'] },
editoptions: { style: "border:0; background-color:transparent;" }
},
{ name: "a21", index: "a21", editable: true, search: true, editrules: { number: true },
formatter: 'currency', summaryType: 'sum'
},
{ name: "a22", index: "a22", editable: true, search: true, editrules: { number: true },
formatter: 'currency', summaryType: 'sum'
},
{ name: "a23", index: "a23", editable: true, search: true, editrules: { number: true },
formatter: 'currency', summaryType: 'sum'
},
{ name: "a24", index: "a24", editable: true, search: true, editrules: { number: true },
formatter: 'currency', summaryType: 'sum'
},
{ name: "a25", index: "a25", editable: true, search: true, editrules: { number: true },
formatter: 'currency', summaryType: 'sum'
}
],
height: 400,
autowidth: true,
width: 700,
rowNum: 70,
rowTotal: 1300,
rowList: [13, 70, 100],
rownumbers: false,
loadonce: true,
loadtext: '載入中...',
forceFit: true,
gridview: true,
pager: '#pager',
sortname: 'ROWNUM',
scroll: 0,
page: 1,
viewrecords: true,
editurl: 'DataHandler.ashx',
sortorder: "asc",
jsonReader: {
root: "rows",
page: "page",
total: "total",
records: "records",
repeatitems: false
},
grouping: false,
groupingView: {
groupField: ['DWJC'],
groupColumnShow: [true],
groupText: ['<b>{0}</b>'],
groupCollapse: false,
groupOrder: ['asc'],
groupSummary: [false],
groupDataSorted: true
},
gridComplete: function () {
$("#jqgridlist").setGridParam({ datatype: 'local' });
},
caption: "<table><tr><td>分組:<select id='chngroup'> <option value='clear'>清除分組</option> <option value='DWJC'>單位名稱</option><option value='JHQJ'>日期期間</option></select></td><td><div class='slider'><div class='slider_context'><ul></ul></div><div class='btn_pre'> </div><div class='btn_next'> </div></div></div></td></tr></table>"
});
datatype:設為 json 時,每次增刪查改都會請求伺服器;設為 local 時,所有操作在前端完成,不發送請求;設為函式(如本範例)時,每次取資料都會先經過該函式處理。
rownumbers:false 不顯示行號,true 則顯示。
loadonce:true 表示一次匯入資料,預設為 false。
rowTotal:一次性匯入資料的最大行數。
jsonReader:負責把伺服器回傳的欄位對應到 grid 的結構,詳見官方文件。
gridComplete:全部資料載入且其他處理都完成後觸發,與 datatype 設定無關,排序、分頁之後也會觸發。若只需要「資料載入完成」這個時機,該用 loadComplete——它在每次伺服器請求後立即執行。
caption:字串型別的表格標題,但這裡可以塞 HTML,是個實用的小技巧。
grouping / groupingView:前者預設 false 不分組;分組的細節設定請參考官方 Demo。
editurl:編輯資料要送出的位址。
jQuery("#jqgridlist").jqGrid('navGrid', '#pager', { edit: false, add: false, del: false }, {}, {}, {}, { multipleSearch: true, closeAfterSearch: true, closeOnEscape: true })
.navButtonAdd("#pager", {
caption: "",
buttonicon: "ui-icon-pencil",
onClickButton: function () {
var gr = jQuery("#jqgridlist").jqGrid("getGridParam", "selrow");
if (gr != null)
jQuery("#jqgridlist").jqGrid("editGridRow", gr, {
afterclickPgButtons: function (whichbutton, formid, rowid) {
var ret = jQuery("#jqgridlist").jqGrid('getRowData', rowid),
objYear = ret.JHQJ;
if (!ValidateDate(objYear)) jQuery("#sData").attr('disabled', 'disabled');
else
jQuery("#sData").removeAttr('disabled');
},
afterShowForm: function (formid) {
var jqgrid = jQuery("#jqgridlist");
var rowid = jqgrid.jqGrid("getGridParam", "selrow"),
ret = jqgrid.jqGrid('getRowData', rowid);
if (!ValidateDate(ret.JHQJ)) jQuery("#sData").attr('disabled', 'disabled');
else
jQuery("#sData").removeAttr('disabled');
},
beforeSubmit: function (postdata, formid) {
var reg = "^(([1-9]\\d*)|0)(\\.\\d{1,2})?$";
if (!Regex(reg, postdata.a21))
return [false, "銷售回款 格式錯誤"];
if (!Regex(reg, postdata.a22))
return [false, "營業收入 格式錯誤"];
if (!Regex(reg, postdata.a23))
return [false, "工業總產值 格式錯誤"];
if (!Regex(reg, postdata.a24))
return [false, "利潤總額 格式錯誤"];
if (!Regex(reg, postdata.a25))
return [false, "上交稅金 格式錯誤"];
else
return [true, ""];
},
afterSubmit: function (response, postdata) {
var json = response.responseText; //format is {status:"success/error",msg:""}
var result = eval("(" + json + ")"), successs = false;
if ("success" == result.status) {
successs = true;
$("#FormError td").html(result.msg);
$("#FormError").show();
}
return [successs, result.msg, ""];
}
});
else
alert("請選擇行");
},
position: "first",
title: "修改",
cursor: "pointer"
}).filterToolbar({ stringResult: true, autosearch: true, searchOnEnter: false, groupOp: "AND" });
function Regex(reg, val) {
var patt = new RegExp(reg, "g");
return patt.test(val);
}
function ValidateDate(objYear) {
var year = null,
month = null,
currentYear = null,
date = new Date();
if (objYear.length == 4) {
year = parseInt(objYear.substr(0, 4));
currentYear = parseInt(date.getFullYear());
} else {
year = parseInt(objYear.substr(0, 6))
month = (date.getMonth() + 1).toString();
month = month.length == 1 ? "0" + month : month;
currentYear = parseInt(date.getFullYear() + month);
}
if (year <= currentYear)
return false; //不可以編輯
else
return true; //可以編輯
}
});
jQuery("#chngroup").live("change", function () {
var vl = $(this).val(); if (vl) {
if (vl == "clear") {
jQuery("#jqgridlist").jqGrid('groupingRemove', true);
} else {
jQuery("#jqgridlist").jqGrid('groupingGroupBy', vl);
}
}
});
function CreateYearList() {
var currentYear = parseInt(new Date().getFullYear());
var mulitYear = currentYear - 1990;
var objul = $(".slider_context ul");
if (mulitYear >= 0) {
for (var index = -1, len = mulitYear; index <= len; index++) {
if (currentYear - index == currentYear)
objul.append("<li class='selected'>" + currentYear.toString() + "</li>");
else
objul.append("<li>" + (currentYear - index).toString() + "</li>");
}
} else {
objul.append("<li class='selected'>" + currentYear.toString() + "</li>");
}
}
$(function () {
CreateYearList();
$(".slider").silder({
speed: "normal",
slideBy: 2
});
});
$(".slider_context li").live("click", function () {
$.each($(".slider_context li"), function (id, item) {
$(this).removeClass('selected');
});
$(this).addClass('selected');
var yearVal = $(this).html();
var jqgrid = $("#jqgridlist");
jqgrid.setGridParam({ datatype: 'json' });
jqgrid.jqGrid('appendPostData', { year: yearVal, f: "year" });
jqgrid.trigger("reloadGrid");
jqgrid.jqGrid('removePostDataItem', "f");
});
var jqgrid = $("#jqgridlist");
//即本次修改前 先將datatype修改成json,否則不能回發到服務器
jqgrid.setGridParam({ datatype: 'json' });
jqgrid.jqGrid('appendPostData', { year: yearVal, f: "year" });//添加PostData
jqgrid.trigger("reloadGrid");//重新加載JqGrid
jqgrid.jqGrid('removePostDataItem', "f");//刪除PostData
並在 gridComplete 中把模式切回本地:
gridComplete: function () {
$("#jqgridlist").setGridParam({ datatype: 'local' });
},
這套「載入後轉本地、要寫回時再轉 json」的循環,是 jqGrid 在讀多寫少的報表場景裡相當實用的模式。
Demo下載地址 /201105/yuanma/JqGridDemo.rar