Kit 是一個 UI 庫,但我並不打算要大家都來背我的 API。今天 jQuery 熱,大家就都去學 jQuery;明天 SeaJS 紅了,大家又都去炒 SeaJS——這種跟風式學習沒有太大意義。所以我在 KitJs 裡專門為 jQuery 使用者準備了一個語法糖(Suger.js),完全模擬 jQuery 的 API,除了實作方式,介面完全一致,方便大家直接把 Kit 的元件拿來改造。當然,對一個純技術迷而言,理解一門技術「怎麼做到」遠比拿來主義有趣得多。
Kit 是個很年輕的庫,仍在持續發展,難免有 bug 與瀏覽器相容問題,我一個人精力有限,歡迎更多志同道合的朋友一起參與。
今天發布了 KitJs 的對話框元件,demo 位於 https://xueduany.github.com/KitJs/KitJs/demo/Dialog/demo.html

在 KitJs 中,kit.js 是核心的 Core 檔,包含最常用的 DOM 與 Object 操作、繼承機制;同級目錄下依功能擴展出 string.js、math.js 等檔案。每個獨立 js 檔都包含一個 Class 構造器與一個全域物件實例。
以 kit.js 為例,它包含 $Kit 類別與其實例 $kit(以 $ 開頭是為了避免與常見變數衝突)。其他模組則以 link 的方式掛在 $Kit 與 $kit 上,例如 math.js 提供 $Kit.Math 類別與 $kit.math 實例,如此一來全域範圍只污染 $Kit 與 $kit 兩個名稱。同時 kit.js 定義了一個命名空間 $kit.ui,對應實體目錄下與 kit.js 同層的 Widget 目錄:

Widget 目錄下的每個子目錄都是 KitJs 的元件,每個獨立 js 檔只包含一個元件類別的構造器(非實例),同時相容 CommonJS 的 module 模式(符合 Modules/1.1 規範,也可改造為 AMD 方式)。
以對話框元件為例,每個元件都類似下面的結構,註解遵循 jsdoc 規範:

首先是 jsdoc 註解:@class 宣告這是哪個類別,@require 宣告相依哪些檔案。
每個類別都以標準的 function(config){} 定義構造器。要注意的是,每個 KitJs 元件的構造器都預留一個 config 參數作為個人化設定輸入,同時類別上有一個靜態成員 defaultConfig,用來存放預設值。
使用時先用 new 建立 $kit.ui.Dialog.YesOrNo 的實例,此時只是產生了 JavaScript 物件,還沒有 HTML;接著呼叫 init 方法建立 HTML 並插入文件,等於給靈魂澆上血肉。

可能有朋友會問:為什麼不把 init 直接放進構造器?兩個原因:
1. 繼承時需要實例化父類。子類繼承父類時,會把子類的 prototype 設為父類的新實例,若構造器裡就呼叫 init,會導致父類的 HTML 被執行,產生垃圾節點。
2. 考慮懶載入。HTML 應該在恰當的時機才建立,而不是一初始化就立刻執行。
所以使用 KitJs 元件的標準流程是:

先實例化,再呼叫 init(init 會回傳當前元件物件,方便串接):

可以發現 dialog 中所有 API method 都掛在 prototype 上,透過原型擴展實作繼承並傳遞給實例:

觀察 $kit.ui.Dialog.YesOrNo 的構造器:

它透過 $kit.inherit 宣告與 $kit.ui.Dialog 的繼承關係。為什麼要寫在構造器裡而不是外面?兩個原因:
1. KitJs 是以 prototype 維護繼承關係的。
2. 使用 KitJs 元件必須先實例化,每個元件都是透過 new 由構造器建立。
因此把繼承動作放在構造器中,實例化新元件時就會沿著當前構造器的繼承鏈,逐級繼承父類的成員與方法。當子類需要改寫父類方法時,只要在子類 prototype 上重新定義同名 method 即可覆蓋。

命名上,KitJs 遵循「子類延續父類名稱作為命名空間」的規則一路鏈下去,如 $kit.ui.Dialog、$kit.ui.Dialog.YesOrNo。
繼承的實作本身並不複雜:

先實例化一個父類物件,把父類實例的所有成員複製到子類原型上,然後把子類原型的 constructor 重設為子類構造器,再給子類構造器掛一個指向父類的 link。透過 $kit.inherit,子類在實例化過程中就能取得父類所有子類沒有的成員,達到近似靜態語言的繼承效果。
Kit 元件的構造器習慣接收一個 Map 型別的參數;初始化時會自動以使用者傳入的 config 覆蓋 defaultConfig 後再開始執行。
任何元件都擺脫不了兩件事:HTML 結構的變化與 CSS 樣式的調整。Kit 把這兩種耦合都分解到 config 裡:
首先使用 HTML 模板技術。Kit 提倡用 $kit.newHTML 由 HTML String 直接產生 DOM 並插入文件流,因此我們把元件主體的 HTML 抽成字串模板放進 defaultConfig。使用者若要自訂結構,只要在初始化時傳入自己的 config 覆蓋模板欄位即可。
而在 HTML 模板與 CSS 的拆解上,Kit 用了一個技巧:把 className 也用樣板變數的方式拉開。

接著在 init 方法中,用 $kit.tpl 把 config 中的 html 以 ${xxx} 的佔位符替換成 config 裡對應的 xxx:

所有樣式都寫在 CSS 裡。若有多套皮膚需要切換,只要在初始化時透過 config 指定 ${cls} 對應的實際 className,就能改寫模板的 class 名稱,達到換膚效果。
透過對 $kit.ui.Dialog.YesOrNo 的程式碼分析,我們大致理解了 KitJs 元件的實作結構。設計一個頁面元件並不難,但設計一個能適應各種需求、在各種場合都能快速變形並配合開發流程的元件,是很高的要求。Kit 透過 HTML 模板與 CSS 的拆分、自訂 config 與 defaultConfig 的配合、子類以繼承取得父類屬性與方法,再依不同商業需求覆寫相關程式碼,基本上能彈性滿足各種層次與環境下的 UI 元件需求。
KitJs 包含基本庫與 UI 庫。基本庫提供:選擇器、DOM 操作、動畫、增強 DOM 事件、hashtree 資料結構、IO、本地儲存、多執行緒、range 等,另外還有一個模擬 jQuery 操作風格的 suger.js。UI 庫則包含增強型表單元素、彈出層、媒體播放器、驗證框架、瀑布流、連動選單、幻燈片、日曆、上傳元件、樣板引擎等。