Dojo EnhancedGrid新功能评介(1)——Pagination

详情请参考http://blog.csdn.net/dojotoolkit/article/details/6409192

Dojo 1.6为dojox.grid.EnhancedGrid以插件的形式增添了一些新的功能。在介绍它们之前，先提一下这个EnhancedGrid的来龙去脉，如果不感兴趣，请直接无视…

顾名思义，EnhancedGrid就是Grid的加强版，从Dojo 1.4开始就有了。它的存在是由于原先的DataGrid虽然功能强大（也非常复杂），但很多地方写得比较死，不太便于扩展。因此，继承自DataGrid的EnhancedGrid就提供了一种较为灵活的插件机制，一方面能使后来的开发者较少受到现有代码的制约（反正是插件，不会删掉原来的代码，可以大胆地重写、覆盖现有函数……当然也只能是不得已而为之啦），另一方面也是为功能日益繁多的Grid瘦身（不用的插件可以不加载）。

Dojo 1.4的EnhancedGrid已经包含了四个插件，分别是：

1. IndirectSelection（行首提供选择框，并支持鼠标拖拉式的范围选择能力）,
2. NestedSorting（多列排序）, 
3. ContextMenu（为表头、行、单元格等提供添加上下文菜单的功能）, 
4. Row/Column DnD（在Grid内部通过拖动改变列或行的顺序，支持多列、多行）。

这些新玩意无疑带来了新气象，因此人们期待在以后的版本中能有更多好用的插件。
Dojo 1.5的 Grid 在功能上没有太大改变，只是修正了一些错误，并新加了一个比较漂亮的主题（ Claro theme ，至少比原来的 Tundra 等等漂亮了不少）。转眼就到了 1.6 。

 

EnhancedGrid的新功能

最新的Dojo 1.6版里，EnhancedGrid引入了几个新的插件，主要有：

1. Pagination（分页浏览）、

2. Filter（一个比较高级的数据过滤器）、

3. Extended Selection（实现了几乎和Excel一样的鼠标选择动作）、

4. Export Framework（一个导出Grid数据的框架，顺便提供了一个导出到CSV的简单实现）、

5. Print（打印Grid中的数据）、

6. Cell Merge（把一行里的几个单元格合并），

7. Row/Column/Cell DnD（完全替换了原有的DnD，不但支持Grid内部的拖放，还能拖到Grid外面）。

另外还对现有插件以及整个插件机制做了很大改进，例如IndirectSelection用图片代替了真实的CheckBox Widget从而更为高效；重构了NestedSorting使代码大大精简；完善了插件声明和使用的机制等等。

本文将分多篇分别介绍这些新功能，同时做一些简单的评价和分析。水平有限，疏漏偏颇之处在所难免，也无法囊括所有的API，权当抛砖引玉了。

 

1. Pagination

 

这个功能真是千呼万唤始出来啊！原先DataGrid对付大数据源的方法只有Virtual Scroll（虚拟滚动），就是在滚动事件触发后才请求后面的数据并创建DOM结点，因此每次只需要显示很少的几行，从而加快了Grid的加载。不得不承认这是一种很精巧的做法，在用户体验上也很自然，就好像所有数据本来就在那里一样。但它也有缺点，除了实现比较复杂之外，还有当数据源真的比较大的时候，滚动条就会非常小，再加上行高参差不齐的情况，要精确地滚动到某个位置就比较困难。这时候简单直观的分页机制就足够了：

第一眼感觉还不错。可以看到分页工具条的左边是从第几行到第几行的描述信息，中间可以设置每页显示的行数，右边则用于切换页面。如果选择中间那个“All”，那就退会到原有的Virtual Scroll了：

中间的这几个行数选项，以及右边最多有几页可见都是可以配置的，甚至左边的描述信息模板也可以定制。让我们看看如何声明并配置一个带分页工具条的Grid：

[javascript]view plaincopy

1. var g = new dojox.grid.EnhancedGrid({  
2.     //……其他配置省略  
3.     plugins: {  
4.     pagination: {  
5.     pageSizes: ['5', '10', '20', 'All'], //注意必须是字符串，至于理由，不要问我…  
6.     maxPageStep: 5, //在右边最多显示几页  
7.     itemTitle: 'items', //默认把每一行称作一个item，当然可以改成别的  
8.     descTemplate: '${2} - ${3} of ${1} ${0}'  
9.     //这个比较复杂，${0}就是刚才的itemTitle，${1}是总行数，${2}和${3}分别是起止行。  
10.     description: true,  //如果设置成False，就没有最左边的描述信息了  
11.     sizeSwitch: true,   //如果设置成False，中间的行数切换就没了  
12.     pageStepper: true   //如果设置成False，右边的页面切换也省了  
13.     }  
14.     }  
15. });  

这些配置其实都是默认值，因此上面的代码跟下面这个效果是一样的：

[javascript]view plaincopy

1. var g = new dojox.grid.EnhancedGrid({  
2.     //……其他配置省略  
3.     plugins: {      pagination: true        //当然，也可以是空对象{}  
4.     }  
5. });  

刚才图中分页工具条的最右边还有个向上的箭头，如果你用默认配置，是没有这个东西的。它是怎么来的？很简单：

[javascript]view plaincopy

1. pagination: {  
2.     //……其他设置项省略  
3.     gotoButton: true    //显示Goto Button，默认是不显示的。  
4. }  

这个按钮点出来是一个对话框（显示在Grid的正中，而不像一般的对话框是在整个窗口的正中），可以直接跳转到某一页：

好是好，可是总感觉弹出对话框的做法有点“重”。就为了翻个页，还要锁住全屏来个模式对话框，如果用过其他Grid，你就会想起葛大爷的话：有这个必要吗？

当然UI这方面的东西总是见仁见智的。不管怎样，单就分页浏览这个功能而言已是一个不小的进步了。

如果是中文环境，可以在加载dojo.js的时候在djConfig里指定locale: 'zh'，如下所示：

[xhtml]view plaincopy

1. <script type="text/javascript" src="./dojo/dojo.js" djConfig="isDebug:false, parseOnLoad: true, locale: 'zh'"></script>  

这样所有的控件文字就变成中文了。不过这里就不用中文作为示例语言了，因为翻译多少有点“蛋疼”：

 

 

没有比较就没有鉴别，顺便看看Dojo的同行们是怎么做的：

jqGrid的分页

ExtJS Grid的分页

撇开那个Goto page对话框不谈，单从功能的强大和完整性来说，赢家还是Dojo，至少别人有的我都有，别人没有的我也有，而且定制灵活，使用方便，的确是居家旅行必备之插件。