ExtJS 4.2 組件的查找方式


組件創建了,就有方法找到這些組件。在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

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM