YUI3:Base

Base类被设计成基础类，YUI库中attribute-base和event target-base的类都衍生自Base类。Base类为在YUI、库中创建的attribute-base类提供统一的模板。Base类还提供统一的init()和destroy()序列，来串联类层级中的初始化（initializer）和销毁（destructor）方法。

Base类还通过插件或扩展的方式，提供代码重用的方法。

使用Base功能

以下部分详细讲解如何使用Base功能。包含以下内容：

• 扩展Base类
• 静态属性NAME属性和ATTRS属性
• 初始化和销毁
• 扩展

扩展Base类

虽然Base类可以被实例化，但是它被设计成基类，用以创建基于Attribute和EventTarget的类。如下：

YUI.use(“base”,function(Y){
	function MyClass(config){
		MyClass.superclass.constructor.apply(this,arguments)
}
	Y.extend(MyClass,Y.Base,{});
})

Base类扩充自Attribute类，而Arribute类又扩充自EventTarget类。因此，Base类具有Attibute功能，也是一个事件目标（Event Target）。

Base的构造器接收一个字面量对象，该字面量对象在构造的过程中用来设置属性的初始值。

静态属性

Base类查找两个静态属性，在类的构造器中必须包含这两个静态属性。在为类设置事件和属性时会使用到这两个静态属性。

YUI.use(“base”,function(Y){
	function MyClass(config){
		MyClass.superclass.constructor.apply(this,arguments)
}
MyClass.NAME = “myclass”;
MyClass.ATTRS = {};
	Y.extend(MyClass,Y.Base,{});
})

NAME

NAME属性是用来标识类的字符串。

NAME属性的一个重要用途是用作类实例所发布事件的前缀。比如，由MyClass类实例发布的事件有myClass前缀。前缀约定为类名的驼峰拼写法。

触发自不同类实例、有着相同名字的事件在冒泡或广播时，事件的前缀保证他们的唯一性和可识别性。比如：在某个Menu widget上的click事件，可以通过订阅menu:click事件来辨别；一个Editor的click可以通过editor:click来识别。因为YUI3.x的自定义事件可以冒泡，这样的前缀允许你在一个更高的层面监听来自不同类的事件。也就是说，你可以像在普通的事件目标上监听一样，使用事件代理。例子：

MyClass.prototype.doSometing = function(){
	this.fire(“enabled”);
}
var o = new MyClass(cfgs);
o.on(“enabled”,function(){});
o.on(“myClass:enabled”,function(){});

NAME属性还在Base的toString的默认实现中使用。

ATTRS

ATTRS属性时一个关联数组（一个有属性/值对的对象），用以定义类实例的默认属性。类层级中的每一个类都定义一组属性以及相应的支持代码，类实例会包含类层级中定义的所有属性。

以下是Drag类中定义的一组属性（部分）：

Drag.ATTRS = {

    node: {
        setter: function(node) {
            var n = Y.one(node);
            if (!n) {
                Y.fail('DD.Drag: Invalid Node Given: ' + node);
            }
            return n;
        }
    },

    dragNode: {
        setter: function(node) {
            var n = Y.one(node);
            if (!n) {
                Y.fail('DD.Drag: Invalid dragNode Given: ' + node);
            }
            return n;
        }
    },

    offsetNode: {
        value: true
    },

    clickPixelThresh: {
        value: DDM.get('clickPixelThresh')
    },

    ...

}; // End of Drag.ATTRS associative array (object literal)

对象字面量中的每一个属性，定义了增加的属性名，以及对应的属性值。更多关于如何构建配置对象请查看Attribute’s discussion of configuration properties。

当初始化一个衍生自Base的类时，Base类的init方法会初始化类层级中每一个类的ATTRS属性定义的属性。这避免在每一个类的constructor/initializer中重复定义属性初始化的代码。

Base类还定义了一个属性初始化顺序，从Base类，到子类。在一个类，ATTRS中定义的属性的顺序是无关紧要的。如果ATTRS中的一个属性在初始化时，需要用到ATTRS后面定义的属性，后面定义的属性会按照需要初始化。

值得注意的是，因为性能方面的原因，Base类惰性地添加或初始化属性。意思是说直到调用set或get方法时，属性才会被初始化。可以通过改变该属性的alazyAdd属性为false，来覆盖默认的惰性行为。（比如某属性的setter方法被用于设置对象中的其他非attribute状态。）

初始化与销毁

Base类实现init和destoy方法，用以建立初始化与销毁这两个生命周期。init方法和destroy方法是不会被Base的子类继承的。扩展自Base类的类通过定义原型级别（prototype-level）的initializer和destructor方法， 可以进行 初始化和销毁操作。如下：

Y.extend(MyClass,Y.Base,{
	initializer:function(cfg){},
	destructor:function(){}
});

Base的init方法和destroy方法负责调用类层级中的initializer方法和destructor方法。每一个类的方法实现不需要调用父类中该方法的实现。Base类确保初始化和销毁过程，根据类的层级按照固定的顺序执行。

initializer()

Base的构造器调用的init方法， 会为类层级中的每一个类调用initializer方法，次序是从Base类开始到当前被初始化的子类。每一个类的initializer方法会在类的属性被初始化后调用。initializer方法会接收到属性初始化后提供的配置对象。该对象是通过init方法传递给initializer方法的。

destructor

Base的destroy方法被调用时，会执行类层级中每一个类的destructor方法。从被实例化创建该实例的子类到Base类。与初始化的顺序相反。

如果你的类在init或destroy过程中，不需要进行任何操作，你就不需要在该类的原型中定义initializer方法和destructor方法。

插件

插件功能可以向衍生自Base类的类实例中添加功能，而不需要把功能写到核心类中。这样的功能允许类实例们混合多种功能，而不需要把这些功能写到一个庞大的类中，或者是为同一序列的功能衍生出很多类。

Plugin.Host类向Base类中添加以下主要方法：

plug(plugClass,plugConfig);

往实例中添加插件与插件配置。plug方法实例化一个插件实例，添加到现有的实例的命名空间（属性）上，该属性名在插件类的NS属性中定义。

plug方法还可以通过数组的方式一次添加多个插件，如下：

instance.plug([{fn:AnimPlug,cfg:{duration:2}},{fn:AnimPlug,cfg:{duration:2}}]);

unplug(plugClass)或unplug(namespace)

从实例中移除插件并将插件销毁。

这两个方法在一个插件实例被创建后，才能使用。还可以在实例化的过程中，通过plugins属性，为实例添加插件，如下：

var overlay = new Overlay({
	srcNode:”#module”,
	plugins:[{fn:AnimPlug,cfg:{duration:2}}]
});

另外，如果组件开发者希望他的组件中默认添加一些插件，Base.plug方法和Base.unplug方法提供这样的接口，让开发者在类定义中默认添加这些插件。

关于插件的开发见Plugin landing page，Widget IO Plugin, Overlay IO Plugin and Overlay Animation Plugin是插件的好例子。

“MyPlugin” template file 提供插件开发的模板。这个模板是通过衍生Plugin.Base类创建插件类的。

扩展

Base类提供一个静态的build方法，通过将一个主类和一个或多个扩展类组合来创建自定义类。

扩展类与插件相似，他们把特定功能的实现封装在扩展类中。但是，扩展是在类的级别上扩展，创建新的类，而插件是在实例的级别上扩展实例。

BUILD

build方法可以用来动态地创建新类，该新类衍生自一个已存在的主类，并参入新的扩展类来增加方法、attribute、事件、属性。默认情况下，build方法不会改变主类，但是，build方法调用时，可以通过配置，让他改变主类。

function Panel(configs){
	Panel.superclass.constructor.apply(this,arguments);
}
Panel.ATTRS = {
	close:{},
	minimize:{},
	show:{}
}
Y.extend(Panel,Y.Base,{
	show:function(){},
	hide:function(){},
	minimize:function(){}
});
function Resizable(){
	this._initResizable();
}
Resizable.ATTRS = {
	handles:{},
	constrain:{}
}
Resizable.prototype = {
	_initResizable:function(){},
	lock:function(){}
}
function Modal(){
	this._initModality();
}
Modal.ATTRS = {
	modal:{},
	region:{}
}
Modal.prototype = {
	_initModality:function(){},
	showMask:function(){},
	hideMask:function(){}
}
var windowPanel = Y.Base.build(“windowPanel”,panel,[Resizable,Modal]);
var wp = new WindowPanel({
	show:true,
	modal:true,
	handles:[“e”,”s”,”es”]
});
wp.lock():
wp.show();

build方法的内部实现：

• 通过扩展主类创建一个新的类；
• 将新的类与传入的扩展类合并，或其他们的原型方法；
• 解析新类上的所有静态属性，需要集合的静态属性在主类的_buildCfg.aggregates属性上。比如：Base类定义ATTRS为必须解析的，Widget类将HTML_PARSER添加为必须解析的静态属性。




当新建的类被实例化时，在init生命周期中，新类会为新类和扩展类调用构造方法。

除了build方法以外，Base类还提供create方法和mix方法。这两个方法是在build方法之上的 “甜点方法”（sugar methods）。

Base.create

该方法为创建新类提供一个更简洁的方法，该方法可以传入额外的静态属性\方法和原型属性\方法。调用方式见API。

Base.mix

该方法可以在现有的类上直接添加扩展类。调用方式见API。