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 FAll descendant Components of E that match F (官方说明-递归向下查询所有可以匹配的组件)

子选择器

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

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

E > FAll 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 ^ FAll parent Components of E that match F

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

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

The'='operator will return the results thatexactlymatch 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 thatexactlymatches one of the whitespace-separated values. This is also true for properties that only haveonevalue:

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])');

varp = Ext.create("Ext.panel.Panel", {

mytest:"myNameIsJack",

width:300,

height:200});

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

The following test will find panels with theirownPropertycollapsed being equal tofalse. 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')}");

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

Ext.define('My.Component', {

override:'Ext.Component',

myMatcher:function() {returnfalse; }

});

Ext.define('My.Panel', {

extend:'Ext.panel.Panel',

requires: ['My.Component'],//Ensure that Component override is appliedmyMatcher:function(selector) {returnselector === 'myPanel';

}

});

Conditional matching(条件匹配)

Attribute matchers can be combined to select only Components that matchallconditions (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 formform.query('field:nth-child(2n+1)');//or use shortcut: :nth-child(odd)//Find every even field in a formform.query('field:nth-child(2n)');//or use shortcut: :nth-child(even)//Find every 3rd field in a formform.query('field:nth-child(3n)');

自定义选择器

//定义一个筛选的方法

//Function receives array and returns a filtered array.Ext.ComponentQuery.pseudos.invalid =function(items) {vari = 0, l = items.length, c, result =[];for(; i < l; i++) {if(!(c =items[i]).isValid()) {

result.push(c);

}

}returnresult;

};

//使用前面构造的方法进行查询

var invalidFields = Ext.ComponentQuery.query('field:invalid', myFormPanel);

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

//Handler receives array of itmes and selector in parenthesesExt.ComponentQuery.pseudos.titleRegex =function(components, selector) {vari = 0, l = components.length, c, result = [], regex =newRegExp(selector);for(; i < l; i++) {

c=components[i];if(c.title &®ex.test(c.title)) {

result.push(c);

}

}returnresult;

}varsalesTabs = 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 祖先组件 第一个符合条件的组件

你可能感兴趣的:(ExtJs ComponentQuery 组件选择器)