組件創建了,就有方法找到這些組件。在DOM、Jquery都有各自的方法查找元素/組件,ExtJS也有自己獨特的方式查找組件、元素。本次從全局查找、容器內查找、form表單查找、通用組件等4個方面介紹組件的查找方式。
目錄
1. 全局查找方式
2. 容器內查找
3. form查找子組件
4. 通用組件查找方式
1. 全局查找方式
全局查找方式指在整個ExtJS框架中查找組件。
1.1 Ext.getCmp(id) :返回此id對應的組件
說明:此方法是在所有組件中查找匹配此id的組件。
參數:
①id {string} :組件的id。
返回值:
{Ext.Component} :返回匹配的組件;若沒有找到返回undefined。
示例:
// 獲取id為reg_form的組件
var form = Ext.getCmp('reg_form');
1.2 Ext.ComponentQuery.query(selector, [root]) :返回一個符合匹配的組件數組
參數:
①selector {string} :匹配規則,可以為組件的xtype、id(前綴加上#)、屬性以及Css Selector。
②root {Ext.container.Container} 可選:指定在哪個容器內進行查詢。 若省略,將進行全局查找。
返回值:
{Ext.Component[]} :返回匹配的組件數組;若沒有找到匹配的,返回一個空數組。
示例:
// 1.xtype查找:獲取所有文本輸入框(xtype:textfield)
var textfieldArray = Ext.ComponentQuery.query('textfield');
// 2.id查找
var formArray = Ext.ComponentQuery.query('#query_form');
// 3.xype+屬性查找:指定from組件,並且title屬性的值為'表單'
var formArray = Ext.ComponentQuery.query('form[title=表單]');
// 4.屬性查找:title屬性的值為'表單'的組件
var formArray = Ext.ComponentQuery.query('[title=表單]');
2. 容器內查找
下面的幾個方法是在容器類型組件內查找對應的子組件或子容器。
2.1 containerObj.child(selecter) :返回第一個符合匹配的第一層子組件
說明:此方法是在容器內的第一層子組件內進行查找。
參數:
①selector {string} :匹配規則,可以為組件的xtype、id(前綴加上#)、屬性以及Css Selector。
返回值:
{Ext.Component} :返回匹配的組件;若沒有找到匹配的,返回null。
示例:
// 返回form表單下的第一層 xtype為fieldcontainer 的子組件
var fc = Ext.getCmp('query_form').child('fieldcontainer');
2.2 containerObj.down([selecter]) :返回第一個符合匹配的子組件
參數:
①selector {string} 可選:匹配規則,可以為組件的xtype、id(前綴加上#)、屬性以及Css Selector。若省略,返回第一個子組件。
返回值:
{Ext.Component} :返回匹配的組件;若沒有找到匹配的,返回null。
示例:
// 返回form表單下的第一個 xtype為textfield 的子組件
var txt = Ext.getCmp('query_form').down('textfield');
2.3 containerObj.query([selecter]) :返回一個組件數組,包含當前容器內符合匹配規則的子組件
參數:
①selector {string} 可選:匹配規則,可以為組件的xtype、id(前綴加上#)、屬性以及Css Selector。若省略,返回所有子組件。
返回值:
{Ext.Component[]} :返回匹配的子組件數組;若沒有找到匹配的,返回一個空數組。
示例:
// 返回form表單下的所有 xtype為textfield 的子組件
var txtArray = Ext.getCmp('query_form').query('textfield');
2.4 containerObj.queryBy(fn, [scope]) :返回一個組件數組,包含當前容器內符函數條件的子組件
參數:
①fn {function} :匹配函數;容器內的每個組件都會調用此函數,函數內返回false不會出現在返回的組件集合里。
②scope {object} 可選:作用域。 若省略,為調用的子組件。
返回值:
{Ext.Component[]} :返回匹配的子組件數組;若沒有找到匹配的,返回一個空數組。
示例:
// 返回表單內有內容的組件
var cpArray = Ext.getCmp('query_form').queryBy(function(cp){
if(cp.getValue){
return cp.getValue().length>0;
}
return false;
})
注意:fn函數只有返回false時,此組件才不加入返回的組件數組里;return undefined、null 這種都是會加入到組件數組里。
2.5 containerObj.queryById(id):返回一個容器內符合此id的子組件
參數:
①id {string} :組件的id,不需要加前綴'#';等同於containerObj.down('#' + id)。
返回值:
{Ext.Component} :返回匹配的子組件;若沒有找到匹配的,返回null。
示例:
// 獲取表單內Id為 A1 的組件
var cp = Ext.getCmp('query_form').queryById('A1');
3. form查找子組件
並不是所有的組件都會賦值Id,在form表單中的組件大多都是采用name屬性。
3.1 formObj.getForm().findField(id/name) :返回form表單內指定id或name的表單組件
參數:
①id/name {string} :組件的id或name。
返回值:
{Ext.form.field.Field} 返回匹配的表單組件;若沒有找到,返回null。
示例:
登錄form表單:
Ext.create('Ext.form.Panel', {
id:'login_form',
title:'登錄',
items:[
{ xtype: 'textfield', name: 'loginName',fieldLabel:'登錄名' },
{ xtype: 'textfield', name: 'loginPwd',fieldLabel:'密碼' },
]
})
獲取值:
Ext.getCmp('login_form').getForm().findField('loginName'); // 獲取登錄名組件
Ext.getCmp('login_form').getForm().findField('loginPwd'); // 獲取密碼組件
4. 通用組件查找方式
通用組件查找方式指的是所有組件都支持的查找方式,主要有以下幾種:
① up() : 向上查找祖先容器。
② previousSibling() :向上查找兄弟組件(同一層級)。
③ nextSibling() :向下查找兄弟組件(同一層級)。
4.1 componentObj.up([selecter]) :返回匹配的祖先容器
參數:
①selector {string} 可選:匹配規則,可以為組件的xtype、id(前綴加上#)、屬性以及Css Selector。若省略,返回第一個上級父容器。
返回值:
{Ext.container.Container} :返回匹配的父容器;若沒有找到匹配的,返回null。
4.2 componentObj.previousSibling([selecter]) :返回向上查找到的兄弟組件(同一層級)
說明:可簡寫為 prev()。
參數:
①selector {string} 可選:匹配規則,可以為組件的xtype、id(前綴加上#)、屬性以及Css Selector。若省略,返回第一個上級父容器。
返回值:
{Ext.Component} :返回匹配的組件;若沒有找到匹配的,返回null。
4.3 componentObj.nextSibling([selecter]) :返回向下查找到的兄弟組件(同一層級)
說明:可簡寫為next()。
參數:
①selector {string} 可選:匹配規則,可以為組件的xtype、id(前綴加上#)、屬性以及Css Selector。若省略,返回第一個上級父容器。
返回值:
{Ext.Component} :返回匹配的組件;若沒有找到匹配的,返回null。
示例

var txt = Ext.getCmp('textfield_B3');
// 1.上級容器
var fc = txt.up(); // => fieldcontainer_B
var form = txt.up().up(); // => form表單
// 2.向上獲取同級組件
var txtB2 = txt.prev(); // => textfield_B2
var txtB1 = txt.prev().prev(); // => textfield_B1
// 3.向下獲取同級組件
var txtB4 = txt.next(); // => textfield_B4
var txtB5 = txt.next().next(); // => textfield_B5
