兩年前寫的,現在發出來,也當是一個記錄。
我知道貼代碼有些人會反對,覺得應該用文字講細致,但是我覺得用文字我沒發用簡單的文字來表達,看代碼反而更直接,這個是見仁見智的。
很早之前一直用extjs,這個確實非常強大,但是在IE下一直都有一個性能的問題,搞得要讓客戶換chrome,firefox瀏覽器才行。
之所以要寫自己js框架,原因是覺得自己實現也簡單,維護也方便,一些管理應用的項目可以用,網站這些我還是推薦直接使用jquery,畢竟更加簡單直接沒有那么多可給你重復應用的地方。
可能你要問為什么不用jquery插件,一樣可以。但是這些插件代碼質量不能保證,風格也是奇形怪狀,出了問題還要去看代碼,改了之后又跟原作者的有出入,以后同步更加麻煩。
不用jquery插件,但是jquery卻是個好東西,解決了瀏覽器兼容的大問題,所以我這個就是基於jquery來實現的,因為一直喜歡extjs的代碼風格,所以如果你使用過extjs的話,使用起來會輕車熟路。
js的繼承是原型繼承的方式,最開始的時候我確實也用原型的方式來實現,但是后面我發現有些問題,而且理解起來不是太清晰,所以我采用一種簡單清晰的方法,寫起來是繼承但是實際上它只是一個對象。
它同樣有着抽象方法,有父類,有重載,有重寫等等。
先看一下大概結構如下圖:
現在說下幾個重要的地方
首先就是如何定義一個類
define: function (className, defaultConfig) { if (!wyl.isString(className) || className.isEmpty()) { throw new Error("[wyl.define] Invalid class name '" + className + "' specified, must be a non-empty string"); } var namespace_arr = className.split('.'); var namespace = window; var class_Name = namespace_arr.last(); wyl.each(namespace_arr, function (ns) { if (ns == class_Name) { return; } if (!namespace[ns]) { namespace[ns] = {}; } namespace = namespace[ns]; }); if (namespace[class_Name]) { throw new Error('重復定義了' + className); } defaultConfig.className = className; for (var p in defaultConfig) { if (wyl.isFunction(defaultConfig[p])) { defaultConfig[p].fnName = p; } } namespace[class_Name] = defaultConfig; }
接着就是如何創建一個類的實例:
getDefineConfig: function (namespaces, i, context) { if (context == null) { return null; } if (namespaces.length == i) { return context; } var ns = namespaces[i]; return wyl.getDefineConfig(namespaces, i + 1, context[ns]); } create: function (className, config) { if (!wyl.isString(className) || className.isEmpty()) { throw new Error("[wyl.create] Invalid class name '" + nsclassName + "' specified, must be a non-empty string"); } var namespaces = className.split('.'); var defineConfig = wyl.getDefineConfig(namespaces, 0, window); if (!defineConfig) { throw '{0}類型未定義。'.format(className); } config = config || {}; if (!config.id) { config.id = wyl.newId(); } var instance = {}; wyl.apply(instance, config, defineConfig); //繼承的關鍵代碼如下 if (instance.extend) { var base = wyl.create(instance.extend); for (var p in base) { if (instance.hasOwnProperty(p)) { //把父類的方法重新命名賦值到這個實例上 if (wyl.isFunction(instance[p]) && wyl.isFunction(base[p])) { var baseFnName = instance.extend + '_' + p; instance[p]['baseFnName'] = instance.extend + '_' + p; instance[baseFnName] = base[p]; } } else { instance[p] = base[p]; } } } instance.initConfig = config; if (typeof (instance.init) == 'function') { instance.init.apply(instance); } if (wyl.isFunction(instance.initComponent)) { instance.initComponent.apply(instance); } wyl.each(instance.abstractMethods, function (methodName) { this[methodName] = function () { throw this.className + ' has not implement ' + methodName; } }, this); this.intanceMgr[instance.id] = instance; return instance; }
對於所有的類型我定義了一個基類
wyl.define('wyl.object', { initConfig: null, abstractMethods: [], //ext4.0中調用父類的方法就是這個 callParent: function () { var me = this; //調用的時候根據之前create里面加入的隱藏信息baseFnName來找到父類的方法並調用它 var fnname = me.callParent.caller['baseFnName']; var fn = me[fnname]; if (wyl.isFunction(fn)) { fn.call(me); } }, addEvents: function () { var me = this; if (!wyl.eventMgr[me.id]) { wyl.eventMgr[me.id] = {}; } var myEventMgr = wyl.eventMgr[me.id]; wyl.each(arguments, function (eventName) { if (!myEventMgr[eventName]) { myEventMgr[eventName] = []; } }); }, fireEvent: function (eventName, prams) { var me = this; var myEventMgr = wyl.eventMgr[me.id]; var listeners = myEventMgr[eventName]; if (wyl.isArray(listeners)) { wyl.each(listeners, function (listener) { var scope = listener.scope ? listener.scope : this; if (listener.callback && typeof (listener.callback) == 'function') { listener.callback.call(scope, prams); } }); } }, on: function (eventName, options) { var me = this; if (!wyl.eventMgr[me.id]) { wyl.eventMgr[me.id] = {}; } var myEventMgr = wyl.eventMgr[me.id]; if (!myEventMgr[eventName]) { myEventMgr[eventName] = []; } var removeIndex = null; wyl.each(myEventMgr[eventName], function (item, i) { var b = options.callback == item.callback; if (b) { removeIndex = i; } return !b; }); if (removeIndex && removeIndex > -1) { myEventMgr[eventName].removeAt(removeIndex); } myEventMgr[eventName].push(options); }, destroy: function () { delete wyl.eventMgr[this.id]; delete wyl.intanceMgr[this.id]; }, init: function () { wyl.apply(this, this.initConfig); } });
界面的控件,我也定義了一個基類:
wyl.define('wyl.Component', { extend: 'wyl.object', containerSelector: null, container: null, abstractMethods: ['render'], getContainer: function () { if (this.container === null) { this.container = $(this.containerSelector).first(); if (this.container == null) { throw '控件必須要設置containerSelector或不存在.'; } } return this.container; }, setContainer: function (selector) { if (typeof (selector) != 'string') { throw '設置container必須是string類型.'; } this.containerSelector = selector; }, getWidth: function () { return this.getContainer().width() - 2; }, getHeight: function () { return this.getContainer().height() - 2; } });
大概的思路就是容器會負責分配給下面子控件的容器setContainer,子控件得到自己的容器getContainer,一個控件不需要關系其他控件,只需要控制好自己內部的控件元素就行了。
里面定義了一個抽象方法render,每個控件都必須實現這個方法。容器render的時候,同時如果自己內部有子控件,也render自己內部的子控件。