ExtJs4常用函数

Posted 周六, 03/28/2015 - 05:05 by admin

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:指定范围.

返回值:无