jqGrid学习笔记（二）

本节介绍jqGrid其他的使用方法，主要是一些基本操作，特殊的数据显示等。
1 刷新jqGrid数据。
常用到刷新jqGrid数据的情况是，在用到查询的时候，根据查询条件，请求数据，并刷新jqGrid表格，使用方式如下：
[javascript]
$("#search_btn").click(function(){
    //此处可以添加对查询数据的合法验证
    var orderId = $("#orderId").val();
    $("#list4").jqGrid('setGridParam',{
        datatype:'json',
        postData:{'orderId':orderId}, //发送数据
        page:1
    }).trigger("reloadGrid"); //重新载入
});

① setGridParam用于设置jqGrid的options选项。返回jqGrid对象
② datatype为指定发送数据的格式；
③ postData为发送请求的数据，以key:value的形式发送，多个参数可以以逗号”,”间隔；
④ page为指定查询结果跳转到第一页；
⑤ trigger(“reloadGrid”);为重新载入jqGrid表格。

2 无数据的提示信息。
当后台返回数据为空时，jqGrid本身的提示信息在右下角，不是很显眼，下面方法将实现在无数据显示的情况下，在jqGrid表格中间位置提示“无数据显示”。如下图：当然，你的div样式可以设置的更好看些。

[javascript]
loadComplete: function() {//如果数据不存在，提示信息
    var rowNum = $("#list4").jqGrid('getGridParam','records');
    if (rowNum      if($("#norecords").html() == null){
            $("#list4").parent().append("</pre>
<div id="norecords">没有查询记录！</div>
<pre>");
        }
        $("#norecords").show();
    }else{//如果存在记录，则隐藏提示信息。
        $("#norecords").hide();
    }
}
① loadComplete 为jqGrid加载完成，执行的方法； ② getGridParam这个方法用来获得jqGrid的选项值。它具有一个可选参数name，name即代表着jqGrid的选项名，如果不传入name参数，则会返回jqGrid整个选项options。例：
[javascript]
$("#list4").jqGrid('getGridParam','records');//获取当前jqGrid的总记录数；
注意：这段代码要加在jqGrid的选项设置Option之间，即：$(“#list4″).jqGrid({});代码之间。且各个option之间加逗号间隔。
3 显示jqGrid统计信息。
通常统计信息都显示在jqGrid表格最后一行，分页控件之上，如下图：

代码片段：
[javascript]
$("#list4").jqGrid({
    ......
    colModel:[
        {name:'productName',index:'productName',align:'center',sortable:false},
        {name:'productAmt',index:'productAmt', align:'center'}
    ],
    footerrow: true,//分页上添加一行，用于显示统计信息
    ......
    pager:$('#gridPager'),
    gridComplete: function() {//当表格所有数据都加载完成，处理统计行数据
        var rowNum = $(this).jqGrid('getGridParam','records');
        if(rowNum > 0){
            var options = {
                url: "test.action",// 默认是form的action，如果写的话，会覆盖from的action.
                dataType: "json",// 'xml', 'script', or 'json' (接受服务端返回的类型.)
                type: "POST",
                success: function(data){//成功后调用方法
                    $("#list4").footerData("set",{productName:"合计",productAmt:data.productAmtSum});
                }
            };
            $("#searchForm").ajaxSubmit(options);
        }
    }
});
详细介绍：
3.1jqGrid的options配置；需要在jqGrid的options中添加如下属性：

[javascript]
footerrow: true,//分页上添加一行，用于显示统计信息
3.2 调用gridComplete方法，当数据加载完成后，处理统计行数据； 3.3调用jqGrid的footerData方法，为统计行赋值：
[javascript]
$("#list4").footerData("set",{productName:"合计",productAmt:data.productAmtSum});
4 jqGrid的数据格式化。
jqGrid中对列表cell属性格式化设置主要通过colModel中formatter、formatoptions来设置
基本用法：
[javascript]
jQuery("#jqGrid_id").jqGrid({
...
   colModel: [
      ...
      {name:'price', index:'price', formatter:'integer', formatoptions:{thousandsSeparator: ','}},
      ...
   ]
...
});
formatter主要是设置格式化类型(integer、email等以及函数来支持自定义类型),formatoptions用来设置对应formatter的参数，jqGrid中预定义了常见的格式及其options：

integer
thousandsSeparator： //千分位分隔符,
defaulValue
number
decimalSeparator, //小数分隔符，如”.”
thousandsSeparator, //千分位分隔符，如”,”
decimalPlaces, //小数保留位数
defaulValue
currency
decimalSeparator, //小数分隔符，如”.”
thousandsSeparator, //千分位分隔符，如”,”
decimalPlaces, //小数保留位数
defaulValue,
prefix //前缀，如加上”$”
suffix//后缀
date
srcformat, //source的本来格式
newformat //新格式
email
没有参数，会在该cell是email加上： mailto:name@domain.com
showlink
baseLinkUrl, //在当前cell中加入link的url，如”jq/query.action”
showAction, //在baseLinkUrl后加入&action=actionName
addParam, //在baseLinkUrl后加入额外的参数，如”&name=aaaa”
target,
idName //默认会在baseLinkUrl后加入,如”.action?id=1″。改如果设置idName=”name”,那么”.action?name=1″。其中取值为当前rowid
checkbox
disabled //true/false 默认为true此时的checkbox不能编辑，如当前cell的值是1、0会将1选中
select
设置下拉框，没有参数，需要和colModel里的editoptions配合使用
下面是一个使用的例子:
[javascript]
colModel:[
{name:'id', index:'id', formatter: customFmatter},

补充：web前端 , JavaScript ,