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