转载自:
http://www.easyui.info/archives/204.html
这篇文章只谈jQuery easyui datagrid 的数据加载,因为这也是大家谈论最多的内容。其实easyui datagrid加载数据只有两种方式:一种是ajax加载目标url返回的json数据;另一种是加载js对象,也就是使用loadDate方法。
这里就自己的使用经验,对两种方式做简单总结和归纳,并且对使用过程中容易产生的误区做较为详细的描述,希望能对大家有所帮助。
url方式加载数据:
调用方式:
目前可能大多数人都是选择这种方式,因为跟流行的框架结合的也比较好,使用url的话,可以将url写在DOM里面或者申明datagrid对象的url属性,以下两种方式都是可以的:
1 | < table id = "tt" style = "width:700px;height:auto" title = "DataGrid" idField = "itemid" url = "datagrid_data2.json" > |
2 | url: 'datagrid_data2.json' |
相关方法:
load | param | 加载第一页数据,param将代替默认查询参数,注意的是该方法只适用于url方式. |
load方法在datagrid的api文档里面写得很清楚了,该方法是加载第一页数据的,在具体的应用中,这个方法主要用于刷新数据。
因为url方式网上的资料特别多,我这里就简述这么多,下面重点讨论一下loadDate方式加载数据。
加载本地数据方式:
首先要明白“加载本地数据”是个什么概念,这里指的是加载javascript对象数据,而javascript数据对象显然可以使是通过其它异步方式获得的,所以这个“加载本地数据”的描述并不准确。
调用方式:
先要将url属性设置为null,或者不设置,然后使用datagrid的loadDate方法加载js数据对象,这个对象包含两个属性,一个是记录总数,一个是当前页码的对象数组。例如:
1 | var obj = { 'total' :100, 'rows' :[{id: '1' ,name: '一' },{id: '2' ,name: '二' }]}; |
2 | $( '#tt' ).datagrid( 'loadData' ,obj); |
如何分页:
不对源码做任何改动的话,可以首先获取datagrid的Pagination对象,然后通过写Pagination对象的onSelectPage事件来实现分页:
14 | $( '#tt' ).datagrid( 'getPager' ).pagination({ |
15 | displayMsg: '当前显示从 [{from}] 到 [{to}] 共[{total}]条记录' , |
16 | onSelectPage : function (pPageIndex, pPageSize) { |
18 | oPage.pageIndex = pPageIndex; |
19 | oPage.pageSize = pPageSize; |
21 | var queryCondition = {name: "世纪之光" }; |
23 | var oData = getAjaxDate( "orderManageBuz" , "qryWorkOrderPaged" ,queryCondition,oPage); |
25 | $( '#tt' ).datagrid( 'loadData' ,{ "total" :oData.page.recordCount, "rows" :oData.data}); |
上面的代码应该很容易看懂了,做出来的分页基本也算正常,不过有一个缺憾,那就是当显示行号的时候,第一页数据是从1-20的话,第二页数据的行号还会保持1-20,同时这些编码似乎也不怎么便捷。
之前我写过jQuery easyui datagrid 非URL后台分页的文章,稍微对easyui datagrid做下扩展,增加一个doPagination事件,那么编码就较为简单了,而且行号不正确的问题也就顺便解决了。
13 | doPagination: function (pPageIndex, pPageSize) { |
15 | oPage.pageIndex = pPageIndex; |
16 | oPage.pageSize = pPageSize; |
18 | var queryCondition = {name: "世纪之光" }; |
20 | var oData = getAjaxDate( "orderManageBuz" , "qryWorkOrderPaged" ,queryCondition,oPage); |
22 | $( '#tt' ).datagrid( 'loadData' ,{ "total" :oData.page.recordCount, "rows" :oData.data}); |
这种方式就不用再去获取Pagination对象了,编码变得简易了,同时还解决了页码显示不正确的问题。
加载中效果:
easyui datagrid只有在使用url方式获取数据的时候才会显示“加载中……”的遮罩效果,使用loadDate方法加载数据的话,其实也可以用上这效果,只不过稍微麻烦些:
13 | doPagination: function (pPageIndex, pPageSize) { |
15 | oPage.pageIndex = pPageIndex; |
16 | oPage.pageSize = pPageSize; |
17 | Exec_Wait( 'tt' , 'loadDateGrid()' ); |
20 | function loadDateGrid(){ |
22 | var queryCondition = {name: "世纪之光" }; |
24 | var oData = getAjaxDate( "orderManageBuz" , "qryWorkOrderPaged" ,queryCondition,oPage); |
26 | $( '#tt' ).datagrid( 'loadData' ,{ "total" :oData.page.recordCount, "rows" :oData.data}); |
35 | function Exec_Wait(grid,func,time){ |
38 | __selector_ = '#' + grid; |
39 | $(__selector_).datagrid( "loading" ); |
43 | gTimeout=window.setTimeout(_Exec_Wait_,dalayTime); |
45 | function _Exec_Wait_(){ |
48 | alert( "__func_:" + __func_ + ";_ExecWait_" + e.message); |
50 | window.clearTimeout(gTimeout); |
51 | $(__selector_).datagrid( "loaded" ); |
当然了,你也可以利用datagrid的onLoadSuccess事件来实现,反正最终都是调用datagrid的loding和loaded方法完成等待DIV的显示和隐藏的:
1 | function loadDateGrid(){ |
2 | $( '#tt' ).datagrid( 'loading' ); |
6 | var oData = getAjaxDate( "orderManageBuz" , "qryWorkOrderPaged" , queryCondition, oPage); |
7 | $( '#tt' ).datagrid( 'loadData' , { |
8 | "total" : oData.page.recordCount, |
14 | onLoadSuccess: function (){ |
16 | $( '#tt' ).datagrid( 'loaded' ); |
如何不统计总数:
有时候数据层的数据量特别大,查询统计总数的话会很耗时,统计总数就显得不怎么合适了,如何不统计总数完全看你后台怎么写了,可以虚拟一个一个总数,这个数字总是比当前页码大1就行了,具体实现就不在本篇文章关注的范围内了。