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