ExtJs4之常用函数

      Ext提供了一个核心的Ext类,该类是单实例类,且不允许直接创建,该类提供了辅助应用Ext的各种组件及控件的调用.

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的类型.