ExtJs4常用函數

1.Ext.onReady()

該方法的調用發生在Document對象加載完畢之後,HTML的onload事件以及image加載之前.

第一個參數爲加載後該方法調用的函數,第三個參數如果爲true則第二個參數將成爲fn的執行範圍,第三個參數如果沒有傳遞,則默認爲true.

此函數非常重要,所有的資源都必須加載完畢方可進行ETJS的函數調用.Ext的DOm等都是動態生成的,而onReady的調用方法在所有Document對象都加載完畢的時候,所以爲了保障請求是安全的,應該保持所有的處理都在onReady中進行.

調用格式:

Ext.onReady(Function fn,Object scope,boolean override)

參數說明:

fn:執行的函數.

scope:fn執行的範圍,爲可選參數.

override:表示是否以scope作爲fn默認的執行範圍,爲可選參數,默認值爲true.

返回值:無.

2.Ext.get()

獲取HTML中的Element,Dom中的Element元素.

調用格式:

Ext.get(Mixed el)

參數說明:

el:一個指定的DOm Element節點id,或者Dom Element,亦或一個存在的HTML Element.

返回值:Element對象.

3.Ext.select()

Ext.select()基於CSS(樣式表)來獲取應用了該樣式表的對象,也就是通常所說的樣式表選擇器.

調用格式:

Ext.select(String/Array selector,[Boolean unique],[HTMLElement/String root])

參數說明:

selector:字符串值,表示通過CSS選擇類型來獲取Element,或者Element組成的數組.

unique:可選參數,是否取得唯一的一個Element,如果該可選值爲false則取符合條件的數組集合.

root:可選參數,選擇器查詢時的根節點,如果該值爲空則指定從Document開始進行查詢.

返回值:

CompositeElementLite/CompositeElement  CompositeElementLite/CompositeElement

如果調用時unique爲true,則返回CompositeElement ,否則返回CompositeElementLite.

4.Ext.query()

通過給定的path,在Dom樹中選擇一個節點數組.真正實現是由Ext.DomQuery.select來完成的,而他只是提供了一種Ext.DomQuery.secect的簡快調用.同時它還提供給了四種選擇器的調用方式,也就是說path可以是四種選擇方式中的任一種路徑,如:按元素選擇方式,按屬性選擇方式,按僞類選擇方式,按CSS樣式表選擇方式.

調用格式:

Ext.query(String path,[Node root])

參數說明:

path:選擇器查詢時的節點path.

root:可選參數,選擇器查詢時的開始節點,如果該值爲空則指定從Document開始進行查詢.

返回值:

Array:返回符合條件的節點數組.

5.Ext.getCmp()

返回Ext.Component管理的指定id的component對象,實際是Ext.ComponentMgr.get(id)的包裝調用.

調用格式:

Ext.getCmp(String id)

參數說明:

id:指定組件的id.

返回值:

Ext.Component:返回Ext.Component的對象或者該類的子類對象.

6.Ext.getDom()

通過指定的id或Dom節點或Element元素,獲取HTMLElement(HTML元素).

調用格式:

Ext.getDom(Mixed el)

參數說明:

el:節點元素或者節點id或者HTML Element.

返回值:

HTMLElement:HTML節點.

7.Ext.isEmpty()

對指定的元素或節點進行判斷,是否爲空.如果指定的節點value是null,undefined則返回true.如果指定的節點是空的字符串對象,且如果允許爲空的字符串(即第二個參數爲true),則返回false,否則返回true.

調用格式:

Ext.isEmpty(Mixed value,[Boolean allowBlank])

參數說明:

value:需要判斷的對象,可以是Object或String等.

allowBlank:可選參數,在判斷對象爲空字符串時,表示是否允許判斷結果爲空,如果允許爲空,則爲空的字符串進行判斷是返回結果爲false,如果不允許爲空,則爲空的字符串進行判斷時返回結果爲true..

返回值:

Boolean:判斷結果是否爲空.

8.Ext.namespace()

創建指定的命名空間後,就可以在該命名空間下定義變量,方法和類.此時這些變量或類將在該命名空間下,當引用該類是需要通過該命名空間方可引用.此時這些變量便屬於指定的命名空間下,避免了這些變量引用時引起的衝突問題.

調用格式:

Ext.namespace(String namespace1,String namespace2 ,String etc)

參數說明:

namespace1和namespace2分別表示命名空間.

9.Ext.each()

分別對一個數組或集合進行迭代,分別對集合中的對象調用指定的函數進行處理.和for循環分別調用一個函數處理指定的集合具有相同的功能.而each()的執行會通過指定的函數來控制是否繼續下一次迭代,如果指定的函數在執行時返回false則會終止迭代的進行.如果指定的界並非真正的集合,迭代僅會執行一個,即第一次迭代後便終止.

調用格式:

Ext.each(Array/NodeList/Mixed array,Function fn,Object scope)

參數說明:

array:指定需要進行迭代的集合

fn:指定集合中的每一個對象進行處理的函數.通過fn執行時,返回結果來控制對集合中的項是否進行下一個元素的fn處理.調用fn的時候,其參數蔣怡fn(item,index,allItems)的形式傳遞,其中item爲進行每一輪迭代的集合中的那個元素,index爲每一輪迭代的下標,allItems爲進行迭代的集合,也就是範圍.

scope:指定範圍.

返回值:無

10.Ext.apply()

爲指定的對象拷貝屬性,或以默認的屬性初始化一個對象.再調用的時候表示將第二個參數config所有的屬性拷貝到第一個參數obj對象的屬性中,如果config爲空,將第三個參數defaults的屬性拷貝到obj的屬性中.

調用格式:

Ext.apply(Object obj, Object config,Object defaults)

參數說明:

obj:目標拷貝對象

config:源拷貝對象屬性集.

defaults:默認屬性值.

返回值:

Object:返回obj,即拷貝完成的對象.

11.Ext.encode()

將定義的JSON對象進行解析,解析成爲字符串,是一個標準的Ext.JSON.encode.在調用時表示將參數Object進行解析,返回字符串.

調用格式:

Ext.encode(Object obj)

參數說明:

obj:需要解析的對象

返回值:String.

12.Ext.htmlDecode()

將定義的HTML字符串進行轉換,支持將轉義字符轉換成HTNL標準字符

調用格式:

Ext.htmlDecode(String value)

參數說明:

value:需要進行轉換的字符串

返回值:String,轉換後的字符串.

13.Ext.typeOf()

判斷傳遞參數的類型,如果參數是未定義對象則返回undefined,如果參數是空格則返回null,如果參數是字符串則返回String,如果參數是一個Dom元素則返回Element如果參數是一個空白的空格字符則返回whitespace.

調用格式:

Ext.typeOf(Mixed value)

參數說明:

value:一個對象,表格,數字,日期對象,表格對象等.

返回值:String,value的類型.

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章