jQuery 短小精悍,是頁面開發的首選,短板在物件導向特性不足(靠外掛補齊);Ext 則是另一個極端,高度物件導向、API 與控制項庫龐大如 MFC,執行時瀏覽器相當吃力,而且用程式碼組出整個介面本身就是件痛苦的事——JavaScript 的弱型別讓 bug 難以在編譯期被攔下,一旦出錯,要在數千行程式碼裡追堆疊簡直令人崩潰。
要在 JavaScript 裡做物件導向,就必須自己準備一批「模擬」機制,這批程式碼就是所謂的核心層。以下這份 JCore 參考了不少 jQuery 與 Ext 的實作,拿來學習很合適。
$import 會依副檔名判斷要動態插入 <script> 還是 <link>,插入前先掃描既有標籤避免重複載入;以 $ 開頭或不含斜線的路徑視為相對路徑,基準點由 $dir 在啟動時從自身 script 標籤的 src 反推得出。
$import: function(importFile){
var file = importFile.toString();
var IsRelativePath = (file.indexOf("$") == 0 || file.indexOf("/") == -1);
var path = file;
if (IsRelativePath){
if (file.indexOf("$") == 0) file = file.substr(1);
path = JCore.$dir + file;
}
var newElement = null;
var ext = path.substr(path.lastIndexOf(".") + 1).toLowerCase();
if (ext == "js"){
var scriptTags = document.getElementsByTagName("script");
for (var i = 0; i < scriptTags.length; i++)
if (scriptTags[i].src && scriptTags[i].src.indexOf(path) != -1) return;
newElement = document.createElement("script");
newElement.type = "text/javascript";
newElement.src = path;
} else if (ext == "css"){
var linkTags = document.getElementsByTagName("link");
for (var i = 0; i < linkTags.length; i++)
if (linkTags[i].href && linkTags[i].href.indexOf(path) != -1) return;
newElement = document.createElement("link");
newElement.type = "text/css";
newElement.rel = "Stylesheet";
newElement.href = path;
} else return;
document.getElementsByTagName("head")[0].appendChild(newElement);
}
標準瀏覽器(Firefox/Opera/Chrome)監聽 DOMContentLoaded;IE 則用一個經典技巧:每 5 毫秒嘗試 document.body.doScroll("left"),在 DOM 就緒前會拋出例外,成功即代表可以執行。程式另外用一個 IsReady 旗標區分「DOM 還沒好」與「使用者程式寫錯了」兩種例外,後者會彈出詳細錯誤資訊,這個細節很實用。
apply: function(oDes, oSrc, bReplace){
if (oDes && oSrc && typeof(oSrc) == 'object'){
for (var p in oSrc){
if (bReplace == false && oDes[p] != null) continue;
oDes[p] = oSrc[p];
}
}
return oDes;
}
這個方法在整份程式碼中被大量用來把擴充方法一次掛到 Function.prototype、String.prototype、Array.prototype、Date.prototype 上。
派生的核心是一個暫時的空格函式 F:讓 F.prototype 指向父類原型,再用 new F() 產生子類原型,如此建立原型鏈卻不執行父類建構式。同時掛上 superclass 供子類呼叫父類建構式,以及 override 供後續補方法。
return function(subFn, superFn, overrides){
var F = function(){}, subFnPrototype, superFnPrototype = superFn.prototype;
F.prototype = superFnPrototype;
subFnPrototype = subFn.prototype = new F();
subFnPrototype.constructor = subFn;
subFn.superclass = superFnPrototype;
if (superFnPrototype.constructor == Object.prototype.constructor)
superFnPrototype.constructor = superFn;
subFn.override = function(obj){ JCore.override(subFn, obj); };
subFnPrototype.override = inlineOverride;
if (overrides) JCore.override(subFn, overrides);
return subFn;
};
程式註解裡整理的可見性規則值得抄下來:子類建構式中的屬性 > 父類建構式中的屬性 > 子類 prototype / overrides > 父類 prototype。因為 extend() 會整個重寫子類的 prototype,所以在子類原型上定義屬性必須寫在 extend 之後,否則會被洗掉。這條規則是原型式繼承最常被忽略的地雷。
createDelegate: function(argsArray, scope){
var method = this;
return function(){
var callArgs = typeof(argsArray) == "undefined" ? [] : argsArray;
callArgs = arguments.length > 0 ? arguments : callArgs;
return method.apply(scope || window, callArgs);
};
},
defer: function(millis /*, args... */){
var callArgs = Array.prototype.slice.call(arguments, 1);
var fn = this.createDelegate(callArgs);
if (millis) return setTimeout(fn, millis);
fn(); return 0;
}
createCallback 收可變參數、createDelegate 收陣列並可指定 scope,createInterceptor 則是 AOP 風格的攔截器:前置函式回傳 false 就中止原方法。這三者在今天都已被 bind、箭頭函式與 ES module 取代,但概念依舊通用。
字串端補了 trim、replaceAll、htmlEncode/Decode、format(以 {0} 佔位)、convertWarpSymbol(可依來源自動在 <br> 與 \r\n 之間轉換)、IsNum;陣列端補了 strip(去重)、exists、indexOf、remove;日期端補了 getElapsed 取得時間差毫秒數。
這份程式碼現在幾乎每一項都有原生替代品:$import → 動態 import();onReady → DOMContentLoaded;extend → class ... extends ... 與 super;createDelegate → Function.prototype.bind;trim/indexOf → 原生字串與陣列方法。真正值得留下來的是它示範的思考方式:在語言功能不足時,如何用最小的一致性介面把差異與缺口服起來。另外提醒,直接擴充 Object.prototype 以外的內建原型(如 Array.prototype)在多人協作與使用第三方庫時容易撞名,現代做法會選擇用 ES module 導出具名工具函式,而不是污染全域原型。