【JEECG技术博文】Local storage & easyui extensions

admin

1. Local storage背景

    cookie弊端：同域内http请求都会带cookie，增加带宽和流量；有个数和大小限制（约4K）。

    在HTML5中，本地存储是一个window的属性，包括localStorage和sessionStorage，从名字应该可以很清楚的辨认二者的区别，前者是一直存在本地的，后者只是伴随着session，窗口一旦关闭就没了。二者用法完全相同。

2. Jquery.storage.js插件

    项目主页，api请参考http://ek.alphaschildren.org/projects/storagejs/

    对于旧版不支持html5的浏览器可以引入jquery.cookie.js插件，就可以用cookie来实现存储，同时storage的api不变，这样应用代码接口调用就独立于存储。

    将相关两个js绑定到basetag的jquery里，因此每个使用到jquery的页面都可以使用storage的api来完成本地信息存储。

    于此同时，修改了plug-in/tools/sysUtil.js和datagrid标签，使得datagrid在表头右键菜单中定义列之后能存储记录，并且在下次打开后能自动恢复。

    在项目中使用方法：

    对于有datagrid标签的页面可以直接使用名为storage的js变量来完成存储工作，例如：

1. <script>  
   
2. storage.set( 'somekey', '{name:”json string”}');  
   
3. var a = storage.get('somekey');  
   
4. alert(a.name);  
   
5. //注意set方法放置json string，在取出时会自动转为json对象，无须自行转换  
   
6. </script>  
   
7. 其他页面单独这样操作（前提是BaseTag引入jquery）：  
   
8. <script>  
   
9. storage=$.localStorage; //优先使用localstorage  
   
10. if(!storage)  
    
11.     storage=$.cookieStorage;//在不支持localstorage的浏览器下使用cookie存储  
    
12. </script>

复制代码

3.Easyui-extensions

    请参考项目demo：http://jqext.sinaapp.com/

    jQuery && jEasyUI 扩展功能集合
    该扩展功能基于 jQuery 1.9.x/2.x 和 jQuery EasyUI 1.3.6 实现

    根据jeecg的使用版本我进行了裁剪和降级，使得组件可以运行于1.3.2版本的easyui，主要是注释掉1.3.4之后加入的tip插件。

    该插件可以通过basetag引入，能够对现有的easyui组件功能和api加强和扩展，在不改动easyui js的情况下扩展对象组件的属性。

4.Easyui extensions使用示例

    参考常用示例中查询编辑器示例：

    使用时只需在baseTag标签加一个属性jeasyuiextensions，例如

1. <t:base type="jquery,easyui,tools,DatePicker,jeasyuiextensions"></t:base>

复制代码

    将原Datagrid 表头菜单去掉：

1. <script>
   
2. //去掉sysUtil.js中定义的原默认右键菜单
   
3. $.fn.datagrid.defaults.onHeaderContextMenu =null;
   
4. $.fn.treegrid.defaults.onHeaderContextMenu =null;
   
5. </script>

复制代码

    表头菜单就会变成如下效果：

    还可以通过datagrid标签的extendParams属性增加自定义菜单，例如：

1. <t:datagrid name="jeecgDemoList2" title="高级查询示例"  actionUrl="jeecgDemoController.do?datagrid"
   
2.         idField="id" queryMode="group" checkbox="true" extendParams="headerContextMenu: [
   
3.                 { text: '保存列定义', iconCls: 'icon-save', disabled: false, handler: function () { saveHeader(); } },
   
4.                 { text: '自定义菜单', iconCls: 'icon-reload', disabled: false, handler: function (e, field) { alert($.string.format('您点击了{0}', field)); } }
   
5.             ],">

复制代码