ExtJs ComponentQuery 组件选择器

ID选择器

根据组件id来选择组件，具有唯一性。前面以”#”号来标志,返回itemid或者id为“panel”的组件实例

var panel = Ext.ComponentQuery.query('#panel');

---

类别选择器

类选择器根据类的xtype来选择，可选择前面是否以”.”来标志，如：根据xtype返回所有Ext.GridPanel实例

var cmp= Ext.ComponentQuery.query('gridpanel');

var cmp= Ext.ComponentQuery.query('.gridpanel');

panel#myPanel 可以通过xtype与id,itemId组件匹配 查找xtype为panel并且id或者itemId为myPanel的所有组件

---

属性选择器

根据组件的属性来选择，可以选择具有某个属性的组件，或者属性为特定值的组件。

var btnOk= Ext.ComponentQuery.query('button[iconCls]'); -返回具有iconCls属性的Ext.Button的实例

Ext.ComponentQuery.query('component[autoScroll]') - 匹配xtype为component的所有组件,并且autoScroll不等于空,不等于false.

也可以选择某个属性为特定值的组件

var btnOk= Ext.ComponentQuery.query('button[text = "ok"]'); -返回text属性为“ok”的Ext.Button的实例

 

值得注意的是,属性可以是任何自定义属性

             Ext.create("Ext.Panel", { myAttribute: "helloWorld" });

Ext.ComponentQuery.query('panel[myAttribute= "helloWorld"]'); -自定义属性也可以匹配的到

---

后代选择器

后代选择器也称为包含选择器，用来选择特定容器或容器组的后代，后代选择器由两个常用选择器，中间加一个空格表示。其中前面的选择器选择父组件，后面的选择器选择后代组件。

var panelsWithinmyCt = Ext.ComponentQuery.query('#myCt panel'); --返回所有id为“myCt”的容器中Ext.Panel实例

E F All descendant Components of E that match F (官方说明-递归向下查询所有可以匹配的组件)

---

子选择器

请注意这个选择器与后代选择器的区别，子选择器（child selector）仅是指它的直接后代，而后代选择器是作用于所有子后代组件。后代选择器通过空格来进行选择，而子选择器是通过“>”进行选择，我们看下面的代码：

var directChildPanel = Ext.ComponentQuery.query('#myCt > panel'); --返回所有id为“myCt”的容器的子组件中的Ext.Panel实例

E > F All direct children Components of E that match F (官方说明-查询直接后代,子孙后代则不匹配)

             Ext.create("Ext.Panel", { itemId: "myCt", itmes:[{ xtype: "panel", html : "我是myCt的直接后代", itmes: [{ xtype: "panel", html : "我是myCt的子孙后代", }] }] });

---

向上选择

E ^ F All parent Components of E that match F

Ext.ComponentQuery.query('textfield ^ form') 查找给定元素 的父容器 （递归向上查找所有匹配元素)

---

 

Attribute matching operators(属性匹配运算符)

The '=' operator will return the results that exactly match the specified object property (attribute):

Ext.ComponentQuery.query('panel[cls=my-cls]'); --精确匹配,匹配xtype为panel的元素,并且cls='my-cls'

会匹配如下组件:

Ext.create('Ext.window.Window', { cls: 'my-cls' })

 

但是不会匹配如下组件:

 Ext.create('Ext.panel.Panel', {

     cls: 'foo-cls my-cls bar-cls'

 });

 

You can use the '~=' operator instead, it will return Components with the property that exactly matches one of the whitespace-separated values. This is also true for properties that only have one value:

Ext.ComponentQuery.query('panel[cls~=my-cls]'); --匹配xtype为panel 并且cls='my-cls' 或者 cls 包含 'my-cls'的所有组件

会匹配下列组件

 

Ext.create('Ext.panel.Panel', { cls: 'foo-cls my-cls bar-cls' }); Ext.create('Ext.window.Window', { cls: 'my-cls' });

Ext.ComponentQuery.query('panel[title^=Sales]');--匹配xtype为panle 并且 title已Sales开头的组件

Ext.create('Ext.panel.Panel', { title: 'Sales estimate for Q4' });

 

Ext.ComponentQuery.query('field[fieldLabel$=name]'); ----匹配属性以给定值结尾的组件

Ext.create('Ext.form.field.Text', { fieldLabel: 'Enter your name' });

 

*= 表达式会匹配属性中包含某个值 无论出现在什么地方都可以匹配
Ext.ComponentQuery.query('Ext.ComponentQuery.query('panel[fuck*=NameIs])');

            var p = Ext.create("Ext.panel.Panel", { mytest: "myNameIsJack", width: 300, height: 200 });

 

@=表达式会匹配组件显示声明的属性,不会去查询原型链中的属性

The following test will find panels with their ownProperty collapsed being equal to false. It will not match a collapsed property from the prototype chain

Ext.ComponentQuery.query('panel[@collapsed=false]')

会匹配如下组件

            Ext.create('Ext.panel.Panel', { collapsed: false });

不会匹配下面的情况,不会通过prototype-china链进行查找

            Ext.create('Ext.panel.Panel', { });

 

var disabledFields = myFormPanel.query("{isDisabled()}"); --可以根据组件的方法进行查找,返回所有isDisabled()返回true的组件

有的时候我们需要自定义的逻辑进行匹配,那么我们可以再组件中定义我们自己的方法.如下:

Ext.ComponentQuery.query("{myMatcher('myPanel')}"); 

但是需要注意必须在所有组件中声明该方法,不然会出现异常.所以我们可以override Ext.Component这个类,默认返回false.然后再子类重写该方法 如下:

 Ext.define('My.Component', { override: 'Ext.Component', myMatcher: function() { return false; } }); Ext.define('My.Panel', { extend: 'Ext.panel.Panel', requires: ['My.Component'],     // Ensure that Component override is applied

     myMatcher: function(selector) { return selector === 'myPanel'; } });

 

---

Conditional matching(条件匹配)

Attribute matchers can be combined to select only Components that match all conditions (logical AND operator):

匹配同时满足多个条件的匹配表达式

Ext.ComponentQuery.query('panel[cls~=my-cls][floating=true][title$="sales data"]');

//匹配xtype为panel的 并且同时满足[cls~=my-cls][floating=true][title$="sales data"]条件的所有组件

 

Expressions separated with commas will match any Component that satisfies either expression (logical OR operator):

匹配用逗号分隔的满足任意一个条件的组件

Ext.ComponentQuery.query('field[fieldLabel^=User], field[fieldLabel*=password]');

//匹配俩种条件field[fieldLabel^=User], field[fieldLabel*=password] 其中的一种条件,或者的关系.只要满足其中一个就匹配得到

 

 

---

 

Pseudo classes(伪类选择器)

:first

// 查询满足条件的第一个元素

Ext.ComponentQuery.query('panel > button:first');

 

:last 

//查询满足条件的最后一个元素

Ext.ComponentQuery.query('form[title=Profile] field:last');

 

:focusable 

//返回可以获得焦点的组件

panel.down(':focusable').focus();

 

:not

//给定一个选择器,匹配相反的结果,返回所有field 但是xtype不是hiddenfield的组件

form.query('field:not(hiddenfield)');

红色部分可以放任何选择器表达式 比如 title^=hello

 

:nth-child 查询奇数，偶数 每隔3个

 

// Find every odd field in a form

 form.query('field:nth-child(2n+1)'); // or use shortcut: :nth-child(odd)



 // Find every even field in a form

 form.query('field:nth-child(2n)');   // or use shortcut: :nth-child(even)



 // Find every 3rd field in a form

 form.query('field:nth-child(3n)');

 

---

自定义选择器 

//定义一个筛选的方法

// Function receives array and returns a filtered array.

Ext.ComponentQuery.pseudos.invalid = function(items) { var i = 0, l = items.length, c, result = []; for (; i < l; i++) { if (!(c = items[i]).isValid()) { result.push(c); } } return result; };

//使用前面构造的方法进行查询
var invalidFields = Ext.ComponentQuery.query('field:invalid', myFormPanel);

 

//还可以给自定义的选择器穿参数

 // Handler receives array of itmes and selector in parentheses

 Ext.ComponentQuery.pseudos.titleRegex = function(components, selector) { var i = 0, l = components.length, c, result = [], regex = new RegExp(selector); for (; i < l; i++) { c = components[i]; if (c.title && regex.test(c.title)) { result.push(c); } } return result; } var salesTabs = tabPanel.query('panel:titleRegex("sales\\s+for\\s+201[123]")');

 

---

 

在容器中查询

query方法查询过程中，默认会遍历所有组件。显然这个是十分影响效率的，把搜索范围限定起来，能使查询速度大大提高。还记得query方法的第二个参数吗？我们这样做：

var btnRefresh = Ext.ComponentQuery.query('#btnRefresh', container);
另一种方式个人比较推荐，因为它看起来特别地干净利落：

var btnRefresh = container.query('#btnRefresh');
说到这里，就不能不提提Container类中用于查询组件的几个方法了。
Container中的query方法、down方法、child方法和up方法，都是基于组件选择器而实现的组件查询方法，调用这些方法，可以很轻松地获取想要的组件。
区别列举如下：

query 后代组件 所有符合条件的组件集合

down 后代组件 第一个符合条件的组件

child 子组件 第一个符合条件的组件

up 祖先组件 第一个符合条件的组件