仿网易邮箱5.0（二）：core.js

今天我们来看在写此UI框架时的第一个js文件，本来想将所有的基本的js都写入此文件，但由于使用jquery而导致这个文件很小，不算注释仅有几十行大小。先上代码，然后我们再来一块说明每个函数在整个框架中的用处。

/**
 * Neter核心库
 * @author Ly
 * @date 2012/11/14
 * @version 1.0
 * @namespace Neter
 */
;(function(window, $) {
    // 插件相对于调用页面的路径
    var __path__  = '',
        __skin__  = '天空蓝',
        __color__ = '#135BA5';
    
    /**
     * @static
     * @class
     * @name Neter
     */
    window.Neter = window.Neter || {};
    
    $.extend(Neter, {
        /**
         * @type String
         * @constant
         * @name Neter.version
         */
        version : '1.0',
        
        /**
         * 创建命名空间
         * @static
         * @function
         * @name Neter.namespace
         * @param {String} namespace 以点分隔的命令空间字符串，即要转换的字符串。
         * @return {Neter} 返回Neter引用
         */
        namespace : function(namespace) {
            var arg = arguments, ns = null, nsArray, obj;
            
            for (var i = 0; i < arg.length; i++) {
                nsArray = arg[i].split('.');
                obj = nsArray[0];
                
                eval('if (typeof ' + obj + ' == "undefined") { ' + obj + ' = {}; } ns = ' + obj + ';');
                
                for (var j = 1; j < nsArray.length; j++) {
                    ns[nsArray[j]] = ns[nsArray[j]] || {};
                    ns = ns[nsArray[j]];
                }
            }
            
            return this;
        },
        /**
         * 日志输入，如果开启Firebug，则直接使用控制台进行输出。若在控制台中无法调用console则不输出日志
         * @static
         * @function
         * @name Neter.log
         * @param {*} msg 要输出的信息，可以是字符串，也可以是一个dom元素，字符串中支持点位符：%d/%s/%o
         * @param {*} [param] 用来填充参数msg点位符的参数，当有此参数时必须传递type参数。
         * @param {String} [type='log'] 输出类型，默认为log，支持info/warning/error等
         */
        'log' : function(msg, param, type) {
            var arg = [].slice.call(arguments, 0);
            
            type = arg.length < 2 ? 'log' : arg.pop();
            
            typeof console === 'object' && typeof console[type] === 'function' && console[type].apply(console, arg);
            
            return this;
        },
        /**
         * 设置或获取插件路径
         * @static
         * @function
         * @name Neter.path
         * @param {String} [path] 插件路径，省略则为获取插件路径
         * @return {String|Neter} 若有path参数，则返回Neter引用，否则返回插件路径。
         */
        path : function(path) {
            if (path) {
                __path__ = path;
            } else {
                return __path__;
            }
            return this;
        },
        /**
         * 拷贝属性
         * @static
         * @function
         * @name Neter.apply
         * @param {Object} aim 目标对象
         * @param {Object} source 源对象
         * @param {Object} [defaults] 默认对象，即用这个对象中的值覆盖源对象中同名属性
         * @param {Array} [mask] 需要屏蔽掉的属性，即不需要拷贝的属性
         * @return {Object} 返回目标对象aim
         */
        apply : function(aim, source, defaults, mask) {
            aim      = aim || {};
            source   = source || {};
            defaults = defaults || {};
            mask     = mask || [];
            
            for (var p in source) {
                if (~$.inArray(p, mask)) { continue; }
                aim[p] = source[p];
            }
            
            for (var p in defaults) {
                if (~$.inArray(p, mask)) { continue; }
                aim[p] = defaults[p];
            }
            
            return aim;
        },
        /**
         * 获取或保存当前系统中正在使用的皮肤
         * @static
         * @function
         * @name Neter.skin
         * @param {String} [name='天空蓝'] 要保存的皮肤名称，省略则获取
         * @return {String|Neter} 若提供color参数则返回Neter引用，否则返回当前的皮肤名称
         */
        skin : function(name) {
            if (name) {
                __skin__ = name;
            } else {
                return __skin__;
            }
            return this;
        },
        /**
         * 设置获取保存当前皮肤的基准色
         * @static
         * @function
         * @name Neter.color
         * @param {Number|String} [color='#135BA5'] 要设置的颜色，省略则获取
         * @return {String|Neter} 若提供color参数则返回Neter引用，否则返回当前的颜色值
         */
        color : function(color) {
            if (typeof color === 'undefined') {
                return __color__;
            } else {
                __color__ = color;
            }
            return this;
        }
    });
})(window, $);

这个文件中的Neter对象很简单，都是些静态方法。

1、version属性，这个就不用说，仅是用来表示当前框架的版本号，可以直接忽略掉。

2、namespace方法，这个是用来生成一个命名空间，主要是用于像是比较长的命名空间的创建，如果很短的话也就无所谓了，咱们自己写也可以，如果像是：Neter.Plugin.Grid.View这种借助于Neter.namespace就很简单了。

// 普通方式
window.Neter = window.Neter || {};
Neter.Plugin = Neter.Plugin || {};
Plugin.Grid  = Plugin.Grid || {};
Grid.View    = Grid.View || {};

// Neter.namespace
Neter.namespace('Neter.Plugin.Grid.View');

3、log方法，此方法其实就是对控制台对象console的一个封装，仅是当控制台未打开时调用console不至于报错。在这里还有一个小问题，即在chrome下console中的方法调用，仅能是console本身调用，也就是说不能写成console.apply(null, [1,2,3]);，但在firebug下就无所谓了。

4、path方法，用来设置或获取当前框架的路径，这个主要是用在框架中使用到图片的地方。

5、apply方法，用来拷贝对象的属性与方法，与jquery中的extend相似，唯一多的就是最后一个参数mask，这个参数是一个数组，数组中的每个元素都是表示在拷贝中要忽略掉的key。

6、skin方法，用来设置与获取当前系统中使用的皮肤，这个在Neter.Skin类中会调用。

7、color方法，用来设置与获取当前系统中使用的基准色，这个基准色也是由Neter.Skin类来控制。

总之，这个文件的功能很少，没有一些实质性的东西，接下来的内容才会涉及到UI相关的。