jqgridstruts2

上一篇中&＃xff0c;jqGrid已经可以从Server端获得数据&＃xff0c;并显示在Grid表格中了。下面说一下&＃xff0c;如何操作Grid表格及其数据。

 http://blog.csdn.net/gengv/article/details/5716347

jqGrid有很多方法函数&＃xff0c;用来操作数据或者操作Grid表格本身。jqGrid的方法有两种调用方式&＃xff1a;

$("#grid_id").jqGridMethod( parameter1,...,parameterN );

或者

$("#grid_id").jqGrid(&＃39;method&＃39;, parameter1,...,parameterN );

首先介绍一下jqGrid的几个最常用的方法函数&＃xff0c;具体的方法API也可以参考官方文档&＃xff08;http://www.trirand.com/jqgridwiki/doku.php?id&＃61;wiki:methods&＃xff09;

1. getGridParam

这个方法用来获得jqGrid的选项值。它具有一个可选参数name&＃xff0c;name即代表着jqGrid的选项名&＃xff0c;例如&＃xff1a;

注&＃xff1a;selrow是jqGrid选项之一&＃xff0c;默认值是null。这是一个只读选项&＃xff0c;代表最后选中行的ID。如果执行翻页或者排序后&＃xff0c;此选项将被设为null。关于其他选项&＃xff0c;后续会有介绍。

如果不传入name参数&＃xff0c;则会返回jqGrid整个选项options。

2. getRowData

这个方法用来获得某行的数据。它具有一个rowid参数&＃xff0c;jqGrid会根据这个rowid返回对应行的数据&＃xff0c;返回的是name:value类型的数组。例如&＃xff1a;

如果rowid未能被找到&＃xff0c;则返回一个空数组&＃xff1b;如果未设置rowid参数&＃xff0c;则以数组的形式返回Grid的所有行数据。

3. addRowData

这个方法用于向Grid中插入新的一行。执行成功返回true&＃xff0c;否则返回false。它具有4个参数&＃xff1a;

• rowid&＃xff1a;新行的id号&＃xff1b;
• data&＃xff1a;新行的数据对象&＃xff0c;形式为{name1:value1,name2: value2…}&＃xff0c;其中name为colModel中定义的列名称name&＃xff1b;
• position&＃xff1a;插入的位置&＃xff08;first&＃xff1a;表格顶端&＃xff1b;last&＃xff1a;表格底端&＃xff1b;before&＃xff1a;srcrowid之前&＃xff1b;after&＃xff1a;srcrowid之后&＃xff09;&＃xff1b;
• srcrowid&＃xff1a;新行将插入到srcrowid指定行的前面或后面。

例如&＃xff1a;

这个方法可以一次性插入多行&＃xff0c;data参数必须是[{name1:value1,name2: value2…}, {name1:value1,name2: value2…}]这样的数组形式&＃xff0c;而且rowid参数也应该设为data参数对象中代表id的field名称。不过&＃xff0c;此时的rowid不用必须是colModel中的一部分。
例如&＃xff1a;

注&＃xff1a;我测试了一下&＃xff0c;一次插入多行的情况下&＃xff0c;用于设置插入位置的后两个参数&＃xff0c;似乎没有起作用。插入的几行数据都被置于Grid的底端。

4. setRowData

这个方法用于为某行数据设置数据值。执行成功返回true&＃xff0c;否则返回false。它具有3个参数&＃xff1a;

• rowid&＃xff1a;更新数据的行id&＃xff1b;
• data&＃xff1a;更新的数据对象&＃xff0c;形式为{name1:value1,name2: value2…}&＃xff0c;其中name为colModel中定义的列名称name&＃xff1b;这个数据对象&＃xff0c;不必设置完全&＃xff0c;需要更新哪列&＃xff0c;就设置哪列的name:value对&＃xff1b;
• cssprop&＃xff1a;如果cssprop为String类型&＃xff0c;则会使用jQuery的addClass为行增加相应名称的CSS类&＃xff1b;如果为object类型&＃xff0c;则会使用html的css属性&＃xff0c;为行添加样式。如果只想增加css样式而不更新数据&＃xff0c;可以将data参数设为false。

例如&＃xff1a;

5. delRowData

这个方法用于删除某行数据。执行成功返回true&＃xff0c;否则返回false。具有一个参数rowid&＃xff0c;代表要删除的行id。例如&＃xff1a;

6. setGridParam

这个方法与getGridParam对应&＃xff0c;用于设置jqGrid的options选项。返回jqGrid对象。参数为{name1:value1,name2: value2…}形式的对象&＃xff08;name来自jqGrid的options选项名&＃xff09;。某些选项在设置之后需要trigger("reloadGrid")&＃xff0c;才能显示出效果。

例如&＃xff1a;

注&＃xff1a;我测试了一下&＃xff0c;这个方法对于设置jqGrid的caption选项似乎无效。大概因此有了setCaption方法。

7. setGridWidth

为Grid动态地设定一个新的宽度。两个参数&＃xff1a;

• new_width&＃xff1a;以px为单位的新宽度值&＃xff1b;
• shrink&＃xff1a;作用与jqGrid的shrinkToFit选项相同&＃xff1b;如果此参数未设置&＃xff0c;则沿用jqGrid的shrinkToFit选项的值。

8. trigger("reloadGrid")

根据当前设置&＃xff0c;重新载入Grid表格&＃xff0c;即意味着向Server发送一个新的请求。此方法只能用于已经构建好的Grid。此外&＃xff0c;此方法不会使对colModel所做出的改变生效。应该使用gridUnload来重新载入对colModel的新设置。

9. 其他方法

除了以上介绍的的方法外&＃xff0c;jqGrid还有其他有用的方法&＃xff0c;例如&＃xff1a;
addJSONData、clearGridData、hideCol、resetSelection、setCaption、setGridHeight、setLabel、showCol等
以及增强模块提供的方法&＃xff0c;例如&＃xff1a;
filterGrid、GridDestroy、GridUnload、setColProp等。

这些方法的具体用法&＃xff0c;或浅显易懂&＃xff0c;或不是非常常用。都可以参考官方文档&＃xff08;http://www.trirand.com/jqgridwiki/doku.php?id&＃61;wiki:methods&＃xff09;&＃xff0c;得到具体指示。

10. 额外的考虑

在上面介绍的增删改数据行的操作中&＃xff0c;jqGrid实际上完成的只是客户端的操作&＃xff0c;主要是DOM的更改工作。但是如果传到Server的请求失败了&＃xff0c;或者没有得到想要的返回结果&＃xff0c;那jqGrid的处理还继续吗&＃xff1f;会不会和Server端的数据不同步了呢&＃xff1f;
这个问题在下一篇中再讨论吧。

注&＃xff1a; 本篇中介绍的方法在jqGrid的Demo中也有介绍&＃xff0c;但是我觉得还是自己的实例看起来更直观&＃xff0c;更适合自己理解。

附上代码&＃xff1a;

Javascript部分&＃xff1a;

html部分&＃xff1a;