• 阻止datagrid填充已经获取到的远程数据


    时光流逝,弹指挥间,不经意的一年又如路上一个动人的靓影悄然消失在视线里。我们往往都是先问自己,我们收获了什么,然后才想到我们付出了什么,很少有人先问自己这一年付出了什么,然后再去看所得。话不多说了,祝靠着搜索引擎来到此地的同仁们,在2013年能够大付出,然后大收入。

    当datagrid设置了url属性,表格就会通过ajax向设置的url请求数据,然后把请求的数据放到已经渲染好的表格容器中,整个过程我们可以这样简单地表示:

    datagrid组件url方式加载数据流程图

    上图的几点说明:

    • onBeforeLoad事件发生在ajax请求之前的,这个事件函数如果返回false的话,将直接结束,不会请求数据。
    • onLoadError事件是当ajax请求出现故障时触发,开发者可以在此事件中自定义提示信息等。
    • onBeforeRender事件是view属性的,该事件发生在把ajax请求到的数据填充到表格内容中之前。
    • 红色部分的rend数据行,就是把ajax请求到的数据填充到表格内容里,这个操作是调用view的render方法实现的。
    • onAfterRender事件也是view对象的事件,该事件在数据填充到表格之后触发。
    • view对象是全局性的,就是说当前页面,所有datagrid对象公用这个view,这是由闭包与面向对象特性决定的,我们来看datagrid的鱼源码:
      /**
       * 自动运行的匿名函数
       * @param {Object} _1b6
       * @param {Object} _1b7
       * @param {Object} _1b8
       */
      (function($){ 
      	//view为匿名函数的内部变量,其指向一个对象。
          var view = {
              render: function(_1b6, _1b7, _1b8){
                  //...
              },
              renderFooter: function(_1bf, _1c0, _1c1){
                  //...
              },
              renderRow: function(_1c4, _1c5, _1c6, _1c7, _1c8){
                  //...
              },
              refreshRow: function(_1ce, _1cf){
                  //...
              },
              updateRow: function(_1d0, _1d1, row){
                  //...
              },
              insertRow: function(_1d7, _1d8, row){
                  //...
              },
              deleteRow: function(_1e2, _1e3){
                  //...
              },
              onBeforeRender: function(_1e8, rows){
      			//user defined
              },
              onAfterRender: function(_1e9){
                  //...
              }
          };
      	//将匿名函数的内部变量赋给$.fn.datagrid.defaults全局对象
      	//这样就构成了闭包,匿名函数内的view变量在匿名函数的运行结束后继续存在于内存中。
          $.fn.datagrid.defaults = $.extend({}, $.fn.panel.defaults, {
              //...
              view: view
      		//...
          });
      })(jQuery);
      

      所以,如果我们更改某个表格的view.onBeforeRender属性的话,其实就是对全局对象的更改,除非我们直接覆盖某个表格的view指向,这样就不会影响其它表格的view了:

      $('#tt').datagrid('options').view.onBeforeRender = function(jq,rows){};//这样就改变了全局变量,对别的grid也会造成影响
      $('#tt').datagrid('options').view = {onBeforeRender :function(jq,rows){},...};//这样只改变了tt表格的view,对别的grid不会造成影响
      
    • onLoadSuccess事件发生最后,这时候数据已经填充到表格,木已成舟,已无回天之力,除非重新砍木头。
    • 在数据填充到表格后,datagrid还有一件事要做,那就是刷新分页工具栏的总记录数值。

    我们可以看到,整个过程中,我们唯一有机会阻止ajax加载到的数据填充到表格的地方就是onBeforeRender事件,只要在这个事件里面,我们将数据设置为空,不过也就没有内容可以填充了;

    我们可以直接覆写某个表格的view,不过代码量太大,所以更改全局的view对象的onBeforeRender事件更为简洁,因view对象是公用的,你更改的话,那么在当前页面,所有表格的view就都跟着改了,所以在view的onBeforeRender最好是通过入参的id标识用以标识哪些表格需要阻止特定数据填充到内容区,所以,我们在页面文档装载完做以下定义:

    $(function() {
    			$.fn.datagrid.defaults.view.onBeforeRender = function(ele, rows) {
    				if (ele.id == 'test') {// 只处理id为test的表格
    					if (rows.length && rows[0].key == -1) {// 这地方我们假设回台返回的数据key为-1的话,则代表此次请求的数据均为错误提示信息,不与展示。
    						$(ele).data('datagrid').data = {
    							total : 0,
    							rows : []
    						};
    						alert(rows[0].error);// 用弹出窗口方式通知用户获取数据出错。
    					}
    				}
    			}
    		});
    
    

    到这里,我们只剩下一个问题了,那就是分页栏还是显示有一条或多条数据,而根据代码的流程图我看可以看出分页栏的刷新是放在最后的,是不是就没辙了呢?别担心,我们有setTimeout这个法宝,在onLoadSuccess事件里面我们延时刷新一下分页栏就行了:

    onLoadSuccess:function(data){
    				setTimeout(function(){
    					var page = $('#test').datagrid("getPager");
    					page.pagination('refresh',{total:0});
    				},100);	
    }
    

    是不是有的童鞋要喊了:“既然分页条能延时刷新,那表格的内容也可以延时清空啊。”,不错表格内容是可以通过延时的方式来清空,但是这个过程用户的眼睛一直盯着表格内容,其展示和被清空的过程被用户看得一清二楚。而分页栏是死角,没人会在意,这就是区别。

    到这里,我们也就算是完美地完成我们想要的效果了,善于思考的同学肯定会问,为什么要用这么别扭的方式,后台报错就直接不要返回什么数据,都放在onLoadError事件里提示不就得了。

    事实上大多人也将异常放在onLoadError中处理的,只有少数情况才会对后台返回的数据有特殊要求,此文更重要的目的是讲述datagrid组件url方式加载和填充数据的过程。

     
    ******转载:http://www.easyui.info/archives/839.html
  • 相关阅读:
    【设计模式】适配器
    【c++算法】变序性算法
    【电信业务】【原则与规范】TMF的NGOSS
    【电信业务】【原则与规范】ITU的TMN
    【c++算法】排序算法
    家后
    【设计模式】桥接
    【电信业务】【原则与规范】SOA 面向服务架构
    UIImage转换成UIView
    ASIHTTPREQUEST网络加载图片
  • 原文地址:https://www.cnblogs.com/linybo/p/10054267.html
Copyright © 2020-2023  润新知