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

忘是亡心i 2022-04-17 00:09 207阅读 0赞

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

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

Dojo1.4的 EnhancedGrid 已经包含了四个插件，分别是：

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

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

# **EnhancedGrid的新功能**  #

最新的Dojo1.6 版里， EnhancedGrid 引入了几个新的插件，主要有：

1.Pagination（分页浏览）、

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

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

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

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

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

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

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

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

## **1. Pagination** ##

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

![0_1305006937rBeB.gif][]

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

中间的这几个行数选项，以及右边最多有几页可见都是可以配置的，甚至左边的描述信息模板也可以定制。让我们看看如何声明并配置一个带分页工具条的Grid ：    
var g = new dojox.grid.EnhancedGrid(\{ //……其他配置省略 plugins: \{ pagination: \{ pageSizes: \['5', '10', '20', 'All'\], //注意必须是字符串，至于理由，不要问我… maxPageStep: 5, //在右边最多显示几页 itemTitle: 'items', //默认把每一行称作一个item，当然可以改成别的 descTemplate: '$\{2\} - $\{3\} of $\{1\} $\{0\}' //这个比较复杂，$\{0\}就是刚才的itemTitle，$\{1\}是总行数，$\{2\}和$\{3\}分别是起止行。 description: true, //如果设置成False，就没有最左边的描述信息了 sizeSwitch: true, //如果设置成False，中间的行数切换就没了 pageStepper: true //如果设置成False，右边的页面切换也省了 \} \} \});

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

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

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

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

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

![0_13050070991tnn.gif][]

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

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

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

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

![0_13050086544siF.gif][]

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

jqGrid的分页

![0_1305008721d8Kk.gif][]

ExtJSGrid的分页

![0_1305008739Gu4K.gif][]

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

（未完待续）

[0_1305006937rBeB.gif]: /images/20220417/07f2b6e9b543408497be0dedff86df66.png
[0_13050070991tnn.gif]: /images/20220417/e3f6f46072374804a906425fef1e30da.png
[0_13050086544siF.gif]: /images/20220417/4a8d2335d76a4857ba65871c97458110.png
[0_1305008721d8Kk.gif]: /images/20220417/86481b0da4ab4f8bb4bbb59e68097946.png
[0_1305008739Gu4K.gif]: /images/20220417/1f7568700b684577b420cb7a3e4acea7.png