ExtJs源码分析与学习—ExtJs元素Element(六)
批量操作元素Ext.CompositeElementLite
该类提供了对一批元素进行相同操作的实现,他是建立在Ext.Element基础上,类中有一个集合,用来保存一批元素。该类的操作依赖于Ext.select,即Ext.Element.select函数来查询元素。先看构造器方法
Ext.CompositeElementLite = function(els, root){ this.elements = []; this.add(els, root); this.el = new Ext.Element.Flyweight(); };
该构造器定义了两个变量,this.elements用来存放要添加的元素,this.el Ext.Element.Flyweight 对象,过程用来处理添加的元素,并利用this.add初始化元素,该方法代码如下:
add : function(els, root){ var me = this, elements = me.elements; if(!els){ return this; } if(typeof els == "string"){ els = Ext.Element.selectorFunction(els, root); }else if(els.isComposite){ els = els.elements; }else if(!Ext.isIterable(els)){ els = [els]; } for(var i = 0, len = els.length; i < len; ++i){ elements.push(me.transformElement(els[i])); } return me; },
该函数根据所传不同参数,处理的会不一样,当els为 string时,会调用Ext.Element.selectorFunction返回数组,数组中元素为HTMLElement,Ext.Element.selectorFunction函数是Ext.DomQuery.select的别名,见Ext.DomQuery类的分析;当els.isComposite为true,即els本身就是Ext.CompositeElementLite的实例对象,那么直接取该对象的elements赋值给els;当els不可迭代,即不是数组,也不是对象。如传一个div元素,那么将其包装成数组。该方法中调用了transformElement
transformElement : function(el){ return Ext.getDom(el); },
该方法把el转换为HTMLElement。下面看原型方法prototype
getCount : function(){ return this.elements.length; },
该方法返回集合this.elements的长度。下面看invoke
/** * 把Ext.Element.prototype中每一个函数包裹成新的函数,并调用执行 * @param {} fn * @param {} args * @return {} */ invoke : function(fn, args){ var me = this, els = me.elements,//元素结合 len = els.length, e, i; for(i = 0; i < len; i++) { e = els[i]; if(e){//对每个元素都执行Ext.Element类的同名函数 Ext.Element.prototype[fn].apply(me.getElement(e), args); } } return me; },
该函数是为以下函数服务的
Ext.CompositeElementLite.importElementMethods = function() { var fnName, ElProto = Ext.Element.prototype, CelProto = Ext.CompositeElementLite.prototype; for (fnName in ElProto) { if (typeof ElProto[fnName] == 'function'){ (function(fnName) { CelProto[fnName] = CelProto[fnName] || function() { return this.invoke(fnName, arguments); }; }).call(CelProto, fnName); } } };
通过下面的调用,把Ext.Element’s prototype复制到Ext.CompositeElementLite’s prototype。
Ext.CompositeElementLite.importElementMethods();
Ext.CompositeElement继承实现了Ext.CompositeElementLite,两者的区别就如同Ext.get和Ext.fly的关系下面看看Ext.CompositeElement中Ext.Element.select方法
Ext.Element.select = function(selector, unique, root){ var els; if(typeof selector == "string"){//css表达式形式 //Ext.Element.selectorFunction实际上是Ext.DomQuery.select函数的别名 els = Ext.Element.selectorFunction(selector, root); }else if(selector.length !== undefined){//元素结合的形式 els = selector; }else{ throw "Invalid selector"; } //构造复合元素,true以Ext.Element形式构件,否则采用Ext.flyweight模式构建 return (unique === true) ? new Ext.CompositeElement(els) : new Ext.CompositeElementLite(els); };
Ext.select可以链式调用,如下代码
Ext.select('p') .addClass('.cls') .on('click',function(){alert(this)});
下面看个简单的例子
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>批量操作元素Ext.CompositeElementLite测试</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <link rel="stylesheet" type="text/css" href="../ext-3.3.1/resources/css/ext-all.css" /> <script type="text/javascript" src="../ext-3.3.1/adapter/ext/ext-base-debug.js"></script> <script type="text/javascript" src="../ext-3.3.1/ext-all-debug-w-comments.js"></script> <script type="text/javascript" src="../ext-3.3.1/src/locale/ext-lang-zh_CN.js"></script> <script type="text/javascript" src="../ext-3.3.1/src/debug.js"></script> <script type="text/javascript"> Ext.onReady(function() { Ext.BLANK_IMAGE_URL = '../ext-3.3.1/resources/images/default/s.gif'; Ext.QuickTips.init(); var els = Ext.select("#some-el div.some-class"); // or select directly from an existing element var el = Ext.get('some-el'); el.select('div.some-class'); els.setWidth(100); // all elements become 100 width els.hide(true); // all elements fade out and hide // or els.setWidth(100).hide(true); }); function show(){ var els = Ext.select("#some-el div.some-class"); els.show(); } </script> </head> <body> <div id="some-el"> <div class="some-class">批量操作元素Ext.CompositeElementLite测试</div> </div> <input type="button" onclick="show();" value="显示"> </body> </html>