1 回答

TA貢獻1765條經驗 獲得超5個贊
jqGrid的調用以及常用增刪改查的使用方法 以下是代碼參考一下吧
jquery grid是富客戶端的,基于XML , Ajax網格插件的jQuery庫。 jqGridView提供專業的解決方案,代表和編輯表格數據在網絡上。精心設計的,具有強大的腳本API的,這可編輯網格是很簡單的DHTML與XML 的配置,并顯示出令人信服的成果與大量數據?,F在我現在熟悉一下jquery grid的的使用方法和一些常用的option設置。
jquery grid是富客戶端的,基于XML , Ajax網格插件的jQuery庫。 jqGridView提供專業的解決方案,代表和編輯表格數據在網絡上。精心設計的,具有強大的腳本API的,這可編輯網格是很簡單的DHTML與XML 的配置,并顯示出令人信服的成果與大量數據。現在我現在熟悉一下jquery grid的的使用方法和一些常用的option設置。
1.調用grid
jqGrid已經可以從Server端獲得數據,并顯示在Grid表格中了。下面說一下,如何操作Grid表格及其數據。
jqGrid有很多方法函數,用來操作數據或者操作Grid表格本身。jqGrid的方法有兩種調用方式:
1 $("#grid_id").jqGridMethod( parameter1,...,parameterN );
或者
1 $("#grid_id").jqGrid('method', parameter1,...,parameterN );
2.常用的方法函數(http://www.trirand.com/jqgridwiki/doku.php?id=wiki:methods )
1. getGridParam
這個方法用來獲得jqGrid的選項值。它具有一個可選參數name,name即代表著jqGrid的選項名,例如:
1 var id = $("#gridTable").jqGrid("getGridParam", "selrow");
即可獲得當前選中的行的ID。
注:selrow是jqGrid選項之一,默認值是null。這是一個只讀選項,代表最后選中行的ID。如果執行翻頁或者排序后,此選項將被設為null。關于其他選項,后續會有介紹。
如果不傳入name參數,則會返回jqGrid整個選項options。
2. getRowData
這個方法用來獲得某行的數據。它具有一個rowid參數,jqGrid會根據這個rowid返回對應行的數據,返回的是name:value類型的數組。例如:
1 var getContact = function() {
2 var selectedId = $("#gridTable").jqGrid("getGridParam", "selrow");
3
4 var rowData = $("#gridTable").jqGrid("getRowData", selectedId);
5
6 alert("First Name: " + rowData.firstName);
7 };
如果rowid未能被找到,則返回一個空數組;如果未設置rowid參數,則以數組的形式返回Grid的所有行數據。
3. addRowData
這個方法用于向Grid中插入新的一行。執行成功返回true,否則返回false。它具有4個參數:
rowid :新行的id號;
data :新行的數據對象,形式為{name1:value1,name2: value2…},其中name為colModel中定義的列名稱name;
position :插入的位置(first:表格頂端;last:表格底端;before:srcrowid之前;after:srcrowid之后);
srcrowid :新行將插入到srcrowid指定行的前面或后面。
例如:
01 var addContact = function() {
02 var selectedId = $("#gridTable").jqGrid("getGridParam", "selrow");
03
04 var dataRow = {
05 id : 99,
06 lastName : "Zhang",
07 firstName : "San",
08 email : "[email protected]",
09 telNo : "0086-12345678"
10 };
11
12 if (selectedId) {
13 $("#gridTable").jqGrid("addRowData", 99, dataRow, "before", selectedId);
14
15 } else {
16 $("#gridTable").jqGrid("addRowData", 99, dataRow, "first");
17
18 }
19 };
這個方法可以一次性插入多行,data參數必須是[{name1:value1,name2: value2…}, {name1:value1,name2: value2…}]這樣的數組形式,而且rowid參數也應該設為data參數對象中代表id的field名稱。不過,此時的rowid不用必須是colModel中的一部分。
例如:
01 var addContact = function() {
02 var selectedId = $("#gridTable").jqGrid("getGridParam", "selrow");
03
04 var dataRow = [{
05 id : 99,
06 lastName : "Zhang",
07 firstName : "San",
08 email : "[email protected]",
09 telNo : "0086-12345678"
10 },
11 {
12 id : 100,
13 lastName : "Li",
14 firstName : "Si",
15 email : "[email protected]",
16 telNo : "0086-12345678"
17 },
18 {
19 id : 101,
20 lastName : "Wang",
21 firstName : "Wu",
22 email : "[email protected]",
23 telNo : "0086-12345678"
24 }];
25
26 if (selectedId) {
27 $("#gridTable").jqGrid("addRowData", "id", dataRow, "before", selectedId);
28
29 } else {
30 $("#gridTable").jqGrid("addRowData", "id", dataRow, "first");
31
32 }
33 };
注:我測試了一下,一次插入多行的情況下,用于設置插入位置的后兩個參數,似乎沒有起作用。插入的幾行數據都被置于Grid的底端。
4. setRowData
這個方法用于為某行數據設置數據值。執行成功返回true,否則返回false。它具有3個參數:
rowid :更新數據的行id;
data :更新的數據對象,形式為{name1:value1,name2: value2…},其中name為colModel中定義的列名稱name;這個數據對象,不必設置完全,需要更新哪列,就設置哪列的name:value對;
cssprop :如果cssprop為String類型,則會使用jQuery的addClass為行增加相應名稱的CSS類;如果為object類型,則會使用html的css屬性,為行添加樣式。如果只想增加css樣式而不更新數據,可以將data參數設為false。
5. delRowData
這個方法用于刪除某行數據。執行成功返回true,否則返回false。具有一個參數rowid,代表要刪除的行id。
6. setGridParam
這個方法與getGridParam對應,用于設置jqGrid的options選項。返回jqGrid對象。參數為{name1:value1,name2: value2…}形式的對象(name來自jqGrid的options選項名)。某些選項在設置之后需要trigger("reloadGrid"),才能顯示出效果。
7. setGridWidth
為Grid動態地設定一個新的寬度。兩個參數:
new_width :以px為單位的新寬度值;
shrink :作用與jqGrid的shrinkToFit選項相同;如果此參數未設置,則沿用jqGrid的shrinkToFit選項的值。
8. trigger("reloadGrid")
根據當前設置,重新載入Grid表格,即意味著向Server發送一個新的請求。此方法只能用于已經構建好的Grid。此外,此方法不會使對colModel所做出的改變生效。應該使用gridUnload來重新載入對colModel的新設置。
9. 其他方法
除了以上介紹的的方法外,jqGrid還有其他有用的方法,例如:
addJSONData、clearGridData、hideCol、resetSelection、setCaption、setGridHeight、setLabel、showCol等
以及增強模塊提供的方法,例如:
filterGrid、GridDestroy、GridUnload、setColProp等。
這些方法的具體用法,或淺顯易懂,或不是非常常用。都可以參考官方文檔(http://www.trirand.com/jqgridwiki/doku.php?id=wiki:methods ),得到具體指示。
10. 額外的考慮
在上面介紹的增刪改數據行的操作中,jqGrid實際上完成的只是客戶端的操作,主要是DOM的更改工作。但是如果傳到Server的請求失敗了,或者沒有得到想要的返回結果,那jqGrid的處理還繼續嗎?會不會和Server端的數據不同步了呢?
這個問題在下一篇中再討論吧。
注: 本篇中介紹的方法在jqGrid的Demo中也有介紹,但是我覺得還是自己的實例看起來更直觀,更適合自己理解。
附上代碼:
javascript部分:
01 $(function(){
02 // 配置jqGrid組件
03 $("#gridTable").jqGrid({
04 url: "jqGrid01.action",
05 datatype: "json",
06 mtype: "GET",
07 height: 350,
08 width: 600,
09 colModel: [
10 {name:"id",index:"id",label:"編碼",width:40},
11 {name:"lastName",index:"lastName",label:"姓",width:80,sortable:false},
12 {name:"firstName",index:"firstName",label:"名",width:80,sortable:false},
13 {name:"email",index:"email",label:"電子郵箱",width:160,sortable:false},
14 {name:"telNo",index:"telNo",label:"電話",width:120,sortable:false}
15 ],
16 viewrecords: true,
17 rowNum: 15,
18 rowList: [15,50,100],
19 prmNames: {search: "search"},
20 jsonReader: {
21 root:"gridModel",
22 records: "record",
23 repeatitems : false
24 },
25 pager: "#gridPager",
26 caption: "聯系人列表",
27 hidegrid: false,
28 shrikToFit: true
29 });
30 });
31 var echoSelRow = function() {
32 var id = $("#gridTable").jqGrid("getGridParam", "selrow");
33
34 alert("當前選中行ID:" + id);
35 };
36 var getContact = function() {
37 var selectedId = $("#gridTable").jqGrid("getGridParam", "selrow");
38
39 var rowData = $("#gridTable").jqGrid("getRowData", selectedId);
40
41 alert("First Name: " + rowData.firstName);
42 };
43 var addContact = function() {
44 var selectedId = $("#gridTable").jqGrid("getGridParam", "selrow");
45
46 var dataRow = {
47 id : 99,
48 lastName : "Zhang",
49 firstName : "San",
50 email : "[email protected]",
51 telNo : "0086-12345678"
52 };
53
54 if (selectedId) {
55 $("#gridTable").jqGrid("addRowData", 99, dataRow, "before", selectedId);
56
57 } else {
58 $("#gridTable").jqGrid("addRowData", 99, dataRow, "first");
59
60 }
61 };
62 var updateContact = function() {
63 var selectedId = $("#gridTable").jqGrid("getGridParam", "selrow");
64
65 var dataRow = {
66 lastName : "Li",
67 firstName : "Si",
68 email : "[email protected]"
69 };
70
71 var cssprop = {
72 color : "#FF0000"
73 };
74
75 $("#gridTable").jqGrid('setRowData', selectedId, dataRow, cssprop);
76 };
77 var deleteContact = function() {
78 var selectedId = $("#gridTable").jqGrid("getGridParam", "selrow");
79
80 $("#gridTable").jqGrid('delRowData', selectedId);
81 };
82 var changeGridOptions = function() {
83 $("#gridTable").jqGrid("setGridParam", {
84 rowNum: 50,
85 page: 16
86 }).trigger('reloadGrid');
87
88 $("#gridTable").jqGrid("setCaption", "Contact List").trigger('reloadGrid');
89
90 alert($("#gridTable").jqGrid("getGridParam", "caption"));
91 alert($("#gridTable").jqGrid("getGridParam", "rowNum"));
92 };
93 var resetWidth = function() {
94 $("#gridTable").jqGrid("setGridWidth", 300, false);
}
html部分:
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh-CN">
<head>
<title>jqGrid02</title>
<link rel="stylesheet" type="text/css" media="screen" href="../css/themes/aero/jquery-ui-1.8.1.custom.css" mce_href="css/themes/aero/jquery-ui-1.8.1.custom.css" />
<link rel="stylesheet" type="text/css" media="screen" href="../css/themes/aero/ui.jqgrid.custom.css" mce_href="css/themes/aero/ui.jqgrid.custom.css" />
<mce:script type="text/javascript" src="../js/jquery-1.4.2.min.js" mce_src="js/jquery-1.4.2.min.js"></mce:script>
<mce:script src="../js/jquery-ui-1.8.1.custom.min.js" mce_src="js/jquery-ui-1.8.1.custom.min.js" type="text/javascript"></mce:script>
<mce:script src="../js/i18n/grid.locale-zh-CN.js" mce_src="js/i18n/grid.locale-zh-CN.js" type="text/javascript"></mce:script>
<mce:script src="../js/jquery.jqGrid.min.js" mce_src="js/jquery.jqGrid.min.js" type="text/javascript"></mce:script>
<mce:script src="js/jqGrid02.js" mce_src="js/jqGrid02.js" type="text/javascript"></mce:script>
</head>
<body>
<h3>
jqGrid測試 02
</h3>
<div>
<table id="gridTable"></table>
<div id="gridPager"></div>
</div>
<br />
<div>
<button onclick="echoSelRow()">當前行ID</button>
<button onclick="getContact()">當前聯系人</button>
<button onclick="addContact()">添加行</button>
<button onclick="updateContact()">修改行</button>
<button onclick="deleteContact()">刪除行</button>
<button onclick="changeGridOptions()">改變Grid選項</button>
<button onclick="resetWidth()">改變Grid寬度</button>
</div>
</body>
</html>
- 1 回答
- 0 關注
- 159 瀏覽
添加回答
舉報