EXT类详解

12.1 Ext类

       Ext类是ExtJS框架的核心实用工具类，在应用程序中经常用到，该类相当于客户端程序与ExtJS框架的一个中间人，很多时候要与系统中运行的Ext控件打交道都需要借助于Ext类。Ext类是一个全局的实用工具类，不需要进行初始化，直接引用即可。比如我们示例中调用Ext类的onReady()来指定在ExtJS框架加载完后执行什么函数，我们可以使用Ext.get("hello")来得到id为hello的DOM元素等，下面我们对Ext实用工具类中一些常用方法的使用作简单介绍。

12.1.1 onReady方法

我们知道，只有在Ext框架全部加载完后才能在客户端的代码中使用Ext，而Ext的onReady正是用来注册在Ext框架及页面的html代码加载完后，所要执行的函数。调用onReady方法时可以带三个参数，第一个参数是必须的，表示要执行的函数或匿名函数，第二参数表示函数的作用域，第三个参数表示函数执行的一些其它特性，比如延迟多少毫秒执行等，大多数情况下只需要第一个参数即可。

比如示例代码会在页面加载后执行函数a，弹出"Everything is ready."的提示信息。

function a(){
alert("Everything is ready.");
}
Ext.onReady(a);

可以在一个页面中多次调用onReady方法，则将会把这些方法放到事件队列中，依次执行；onReady的第三个参数是事件执行的一些特殊属性描述，可以是简单的true或false，也可以是一个对象，对象中可以包含delay、single、buffer等属性，比如在上面的代码中添加下面的代码：

Ext.onReady(function(){alert("2")},this,{delay:5000});

则在页面加载完成后，执行了a方法中的内容，5秒后会执行上面onReady方法中的匿名函数。

作用域是javascript中一个比较关键的特性，我们可以在事件中执行某一个函数的执行的作用域，下面的代码演示了在onReady方法中使用作用域。

var b1={v:"this is b1"};
var b2={v:"this is b2"};
function b()
{
	alert(this.v);
}
Ext.onReady(b,b1);
Ext.onReady(b,b2);

上面的代码直接调Ext类的onReady方法指定在页面加载完后执行函数b，函数b中的代码是输出当前对象的v属性值，执行这段代码可以看到onReady中作用域的效果。

12.1.2 get系列方法

Ext中包含了几个以get开头的方法，这些方法可以用来得到文档中DOM、得到当前文档中的组件、得到Ext元素等，在使用中要注意区别使用。

1 、get 方法

get方法用来得到一个Ext元素，也就是类型为Ext.Element的对象，Ext.Element类是Ext对DOM的封装，代表DOM的元素，可以为每一个DOM创建一个对应的Element对象，可以通过Element对象上的方法来实现对DOM指定的操作，比如用hide方法可以隐藏元素、initDD方法可以让指定的DOM具有拖放特性等。get方法其实是Ext.Element.get的简写形式。

get 方法中只有一个参数，这个参数是混合参数，可以是 DOM 节点的 id 、也可以是一个 Element 、或者是一个 DOM 节点对象等。看下面的示例代码：

Ext.onReady(function(){
var e=new Ext.Element("hello");
alert(Ext.get("hello"));
alert(Ext.get(document.getElementById("hello")));
alert(Ext.get(e));
});
Html页面中包含一个id为hello的div，代码如下：
<div id="hello">tttt</div>

Ext.get("hello")、Ext.get(document.getElementById("hello"))、Ext.get(e)等三个方法都可以得到一个与DOM节点hello对应的Ext元素。

2 、getCmp 方法－获得Ext 组件。

getCmp方法用来获得一个Ext组件，也就是一个已经在页面中初始化了的Component或其子类的对象，getCmp方法其实是Ext.ComponentMgr.get方法的简写形式。getCmp方法中只有一个参数，也就是组件的id。比如下面的代码：

Ext.onReady(function(){
var h=new Ext.Panel({
id:"h2",
title:"　",
renderTo:"hello",
width:300,
height:200});
Ext.getCmp("h2").setTitle("新的标题");
});

在代码中，我们使用Ext.getCmp("h2").来得到id为h2的组件，并调用其setTitle方法来设置该面板的标题。

3 、getDom 方法－获得DOM 节点

getDom方法能够得到文档中的DOM节点，该方法中包含一个参数，该参数可以是DOM节点的id、DOM节点对象或DOM节点对应的Ext元素(Element)等。比如下面的代码：

Ext.onReady(function(){
var e=new Ext.Element("hello");
Ext.getDom("hello");
Ext.getDom(e);
Ext.getDom(e.dom);
});
Html：
<div id="hello">tttt</div>

在上面的代码中，Ext.getDom("hello")、Ext.getDom(e)、Ext.getDom(e.dom)等三个语句返回都是同一个DOM节点对象。

 

4 、getBody 方法－得到文档的body 节点元素(Element) 。

该方法直接得到文档中与document.body这个DOM节点对应的ExtJS元素（Element），实质就是把document.body对象封装成ExtJS元素对象返回，该方法不带任何参数。比如下面的代码把面板h直接渲染到文档的body元素中。

Ext.onReady(function(){
var h=new Ext.Panel({title:"测试",width:300,height:200});
h.render(Ext.getBody());
});

5 、getDoc 方法－获得与document 对应的Ext 元素(Element)

getDoc方法实质上就是把当前html文档对象，也就是把document对象封装成ExtJS的Element对象返回，该方法不带任何参数。

 

12.1.3 apply及applyIf方法

apply及applyIf方法都是用于实现把一个对象中的属性应用于另外一个对象中，相当于属性拷贝。不同的是apply将会覆盖目标对象中的属性，而applyIf只拷贝目标对象中没有而源对象中有的属性。

apply方法的签名为“apply( Object obj, Object config, Object defaults ) : Object”，该方法包含三个参数，第一个参数是要拷贝的目标对象，第二个参数是拷贝的源对象，第三个参数是可选的，表示给目标对象提供一个默认值。可以简单的理解成把第三个参数（如果有的话）及第二个参数中的属性拷贝给第一个参数对象。看下面的代码：

var b1={
	p1:"p1 value",
	p2:"p2 value",
	f1:function(){alert(this.p2)}
};
var b2=new Object();
b2.p2="b2 value";
Ext.apply(b2,b1);
b2.f1();

在上面的代码中，Ext.apply(b2,b1)这一语句把b1的属性拷贝到了b2对象中，因此调用b2的f1方法可以弹出"p2 value"的提示信息。尽管b2对象已经包含了p2属性值，但拷贝后该属性值会被覆盖。可以在调用apply方法时，在第三个参数中指定拷贝属性的默认值，比如下面的代码：

Ext.apply(b2,b1,{p3:"p3 value"});
alert(b2.p3);

这样会使得b2中包含一个p3的属性，值为"p3 value"。

applyIf方法的功能跟apply一样，只是不会拷贝那些在目标对象及源对象都存在的属性。比如把前面演示apply方法的代码改成applyIf，如下：

Ext.applyIf(b2,b1);
b2.f1();

由于b2中已经存在了p2属性，因此，b2.f1()方法中引用this.p2的时候，得到的是"b2 value"，而不是在b1中定义的"p2 value"。