jqGrid查询配置

　　jqGrid的列可以用于查询表单。表格查询按照规则从服务器加载数据。

有4中查询方法

• 工具栏查询（ toolbar searching）
• 自定义查询（custom searching）
• 单字段查询（single field searching）
• 更复杂的多字段条件查新-高级查询（advanced searching）

　　这些方法使用jqGrid通用选项，仅能在已经构造过的grid上调用。

　　每个查询方法需要附加的模块，这些模块需要倒入。

　　所有查询模块（除了自定义查询和工具栏查询）使用下面的语言文件中的默认定义

$.jgrid = {
//...
   search : {
     caption: "Search...",
     Find: "Find",
     Reset: "Reset",
     odata : ['equal', 'not equal', 'less', 'less or equal','greater','greater or equal', 'begins with','does not begin with','is in','is not in','ends with','does not end with','contains','does not contain'],
     groupOps: [ { op: "AND", text: "all" }, { op: "OR", text: "any" } ],
     matchText: " match",
     rulesText: " rules"
   },
//...

　　jqGrid3.5+每个查询模块都可以使用通用查询选项。下面为一些选项，在colModel中配置。 注意，不是所有选项对特定方法都有效。

 searchoptions对象配置

这些配置不适用自定义查询方法，这个方法使用另外的选择

<select>
<option value=“1”>One</option>
<option value=“2”>Two</option>
</select>

dataInit: function(elem) {
//do something
}

dataInit : function (elem) {
$(elem).datepicker();
}

dataEvents: [
{ type: 'click', data: { i: 7 }, fn: function(e) { console.log(e.data.i); }},
{ type: 'keypress', fn: function(e) { console.log('keypress'); } }
]

attr : { title: “Some title” }//给查询对象增加title属性

注意：stype为select，searchoptions没有设置dataUrl，将从searchoptions的value属性获取，2个都没定义则从colModel定义的editoptions中获取。

在colModel中定义可查询元素附加的属性。通常用于在提交数据到服务器前，验证用户输入的数据，调用方式

jQuery("#grid_id").jqGrid({
...
   colModel: [ 
      ... 
      {name:'price', ..., searchrules:{required:true....}, search:true },
      ...
   ]
...
});

下面为可用选项

“searchrules仅用于查询对话框，不用于查询过滤（searching filter）”，参考：[http://stackoverflow.com/a/9011733]

• 所有查询模块使用jqGrid配置中的url。某些方法的参数可以配置来替代这个url。
• 执行查询时，postData中自动填充需要的数据。
• 配置jqGrid的search参数以便启用查询功能。服务器端的名称为 _search（注意不同），可以通过GET或者POST方法获取。
• jqGrid有searchdata配置，给查询附加额外参数，用于扩展postData对象。（For the search we have additional array searchdata array in the grid options. This array extends the postData array）.
• 点击导航层的刷新按钮触发grid重新加载时，search被设置为false。
• 每个查询方法创建自己的方法用于清空postData对象中的查询数据。