Extjs4中up()和down()的用法以及组件查找_ComponentQuery类

来源：互联网发布：qq邮箱下载mac 编辑：程序博客网时间：2024/05/13 20:01

Extjs4中up()和down()的用法

Extjs4.x中，新增加了两个方法up()和down()方法。这两个方法都是用来获取组件的，下面我们来看下官方解释。

up( String selector, [Number/Mixed maxDepth] ) : Ext.core.Element

selector:必选，字符串形式，表示要匹配的组件。

Maxdepth:可选，表示要匹配的最大深度。

up方法的API解释为：通过简单的选择，获得相匹配的dom，使用up方法总是返回一个Ext.core.Element，也就是ext的组件。

down( String selector, [Boolean returnDom] ) : HTMLElement/Ext.core.Element

selector:必选，字符串形式，表示要匹配的组件，

returnDom：可选，布尔类型，如果为true，则返回DOM节点，而不是Ext.core.Element。值默认为false。

down方法的API解释，通过选择器,来获得任何深度的子组件，在down方法中，不应该包含组件的id，而应该是组件的xtype。

下面我们来看他的用法。先看一段代码。

[javascript] view plaincopy
Ext.require('Ext.*');  
 Ext.onReady(function(){  
  var win = Ext.create('Ext.window.Window',{  
   height: 160,  
   width: 280,  
   title: '用户登陆',  
   closeAction: 'hide',  
   closable : false,   
   iconCls: 'win',  
   layout: 'fit',  
   modal : true,   
   plain : true,  
   resizable: false,  
   items:[{  
    xtype:'form',  
    items:[{  
     //.....   
    }],  
    button:[{  
     text:'登录',  
     handler:function(){  
        
     }  
    }]  
   }]  
  })   
 });  

这段代码中，我们创建了一个window，然后在window中添加了一个form。最后增加了一个button。button的handler，我们定义了一个function。下一步，我们在这个function中添加代码。

[javascript] view plaincopy
var form = this.up(‘form’).getForm();  

这里用到了this.up。具体解释下。这里this。就是button组件，up(‘form’)是指匹配form组件。那么合起来，我们就得到了form组件，并且得到整个form。

在这个例子中，我们并不需要down方法。因为无论是获取form还是window.我们都可以使用this.up(‘form’)或this.up(‘window’)来获取form组件和window组件。

为了介绍下down方法。我们将整个过程复杂化一些。

[javascript] view plaincopy
var form = this.up(‘window’).down(‘form’).getForm();  

相信大家已经很明白了,this.up(‘window’)获取了顶级的window组件。接着使用down()方法获取了window的子组件form组件，最后使用getForm()来获取整个form。

组件查找_ComponentQuery类

Extjs4.0组件查找使用了ComponentQuery类，使用这个类能更加方便地查找容器内的组件。实现方式类似于CSS的Selector。
下面将extjs3和extjs4各种查找组件的方式做下简介。
Extjs3.x：

    ID：这就是所熟知的Ext.getCmp(“组件ID”)，缺点是id重复导致出错。
    ref：在EXTJS3中，所有的组件都会有一个ref属性，也就是reference的意思。这种方式是通过对组件的引用而得到组件对象。例如：ref:’mypanel’，但是这种方式的局限性在于，他只能查找不同层级之间的组件。也就是说A[a,b,c] C[d,e,f]，这样的方式，使用ref非常方便，但如果是B[c,c,d]这样的方式，就会出现问题，因为在某一层级上，出项了两个相同的组件。
    items.get(0)：这种方式是通过首先获得组件中所有元素的数组，然后通过数组获得想要的组件对象，一般不会用到，因为非常不灵活，如果元素层级发生改变的话，将不能获取想要的组件，维护起来也非常困难。所以，这种方式，是用的最少的一种方式。

Extjs4.x：

在Extjs4.0中，依然可以沿用Extjs3.x中查找组件的方式，但是在Extjs4.0中，可以利用ComponentQuery，更方便找到对应组件。

1、通过组件ID获取组件："#组件ID”，如果通过这种方式，那么一定要记住在组件ID前添加#号。

[javascript] view plaincopy
// 通过ID获得组件:#ID    
//   var items = Ext.ComponentQuery.query('#btn2',panel);    

2、得到某一组件下所有的指定类型的组件："panel>button”，这种方式是查找所有panel组件下的所有button组件。

[javascript] view plaincopy
// 获得panel下的所有button,这个需要注意，button必须在panel下的第一层，如果中间跨层是找不到的，如：'viewport>button'是找不到button的，因为中间有一层panel    
//   var items = Ext.ComponentQuery.query('panel>button',panel);    

3、通过xtype："treepanel”或".treepanel

[javascript] view plaincopy
// 如果是多个类别，可以逗号隔开，如：'gridpanel,treepanel'    
       var items = Ext.ComponentQuery.query('button',panel);    

4、如果想获取所有button并且action为save的button，则可以使用"button[action=save] "，又或者获取所有panel，并且autoscroll属性为true的panel，则可以使用"panel[autoScroll=true]"

[javascript] view plaincopy
// 通过组件的属性来查找    
 //   var items = Ext.ComponentQuery.query('button[id=btn2]',panel);    

        note:通过属性查找的时候中括号要紧挨着类名，如上据代码button和[id=btn1]之间不能有空格！

    5、还有两种方式，是查找某一组件的子组件或上级组件，例如：

            1、查找window下的form：win.down(“form”)
            2、查找button的父组件window:button.up(“window”);

    最明显的例子就是在extjs4.0使用MVC模式进行开发的时候，经常会在control控制中大量使用'viewport > panel'，’edit button[action=save]’这类查找，当点击button进行数据保存的时候，会使用

[javascript] view plaincopy
var win   = button.up('window'),      
 form   = win.down('form'),     
record = form.getRecord(),    

这类型的查找进行数据更新。

最后，在extjs4.0 MVC模式中，经常会碰到

[javascript] view plaincopy
refs:[    
    {ref: 'menu',selector: 'tablepanel'},    
    {ref: 'feedList', selector: 'feedlist'},    
    {    
        ref: 'feedWindow',     
        selector: 'feedwindow',     
        autoCreate: true,    
        xtype: 'feedwindow'    
    }    
]    

    这样的书写方式。有很多人问我这是什么意思，查API也找不到。网络上也找不到，其实看extjs3.x中查找组件的方式，就会明白了。Refs是一个查找并匹配组件的集合，集合里面则指定了需要的操作，即查找一个组件，而找到的这个组件所匹配组件就是selector指定的，用上面代码一条

        {ref: 'menu',selector: 'tablepanel'}

    来稍做解释，即查找menu组件（其实是一颗树），点击树节点，结果将在'tablepanel'中渲染。这样解释可能比较含糊，那么就用官方例子做个解释吧。

        {ref: 'feedData', selector: 'feedlist dataview'}。

    这条的含义是查找'feedData'，将'feedData'渲染在'feedlist的子组件dataview'上。

    总结下：在ExtJS4中所有的组件都有一个query方法，这个方法就是ComponentQuery的实现。当然，如果还是不明白的话，就可以使用：

[javascript] view plaincopy
Ext.ComponentQuery.query("tabpanel");  
  
Ext.ComponentQuery.query("#mytree");  

实在extjs4.0实际使用过程中，如果要调用或查找组件，exjts会自动调用ComponentQuery的query方法来查找对应组件。

例子：

[javascript] view plaincopy
init:function(){  
  
    this.control({  
  
        'smsmenu': {//这里不必写全部的代码Ext.ComponentQuery.query(…);  
  
             itemmousedown: this.loadMenu  
  
        }  
  
    })

0 0