模組化能讓前端程式碼從「一坨大檔案」變成「一組各司其職的小單元」,但入門門檻往往卡在工具本身:require.js 要學、CMD/AMD 規範要看,一整套配置下來,時間先耗掉一半。
mini-define 就是為這個痛點而生——依據 require 的思路實作的簡易前端模組化框架。如果你不想花時間研究 require.js,也不想翻長篇規範文件,它是個不錯的起點;如果你已經用過 Sea.js 或 require.js,那麼它會顯得更輕、更直接。
定義時可以依「有沒有依賴」分成兩種寫法。
沒有依賴的模組:
define('id', function () {
// 在這裡寫你的程式碼
});
有依賴的模組,把依賴名稱放進陣列,對應的物件會依序傳入回呼函式:
define('id', ['modeA', 'modeB'], function (A, B) {
// 在這裡寫你的程式碼
});
另一個維度是「要不要把結果交給外部使用」。需要對外提供時,用 return 把物件還出去:
define('id', function () {
return {
// 對外暴露的成員
};
});
純粹執行副作用、不需要對外輸出的話,不 return 也完全可行:
define('id', function () {
// 在這裡寫你的程式碼
});
呼叫端同樣有兩種粒度。載入單一模組:
require('modeId');
一次載入多個:
require(['modeA', 'modeB']);
如果需要在載入完成後接著做事,可以帶上回呼函式:
require('modeId', function (mode) {
// 在這裡處理載入完成的模組
});
require(['modeA', 'modeB'], function (A, B) {
// 在這裡處理載入完成的模組
});
不需要後續處理時,直接呼叫即可:
require('modeId');
接著在 index.html 依序引入核心與各個模組檔:
<!-- 核心模組 --> <script src="lib/core/require.js"></script> <!-- 用於示範的模組 --> <script src="lib/main.js"></script> <script src="lib/config.js"></script> <script src="lib/init.js"></script>
開發階段這樣各自獨立很清楚,但上線前建議用你熟悉的打包工具把 lib 目錄合併壓縮成一個檔案,減少請求數:
<script src="lib/min.js"></script>
打包完成後,index.html 只需要留這一行。
mini-define 最大的特色就是小。跟 Sea.js 或原版 require.js 比起來,加上註解才一百來行的程式碼,用「輕量」形容都嫌它太胖。裡面沒有什麼高深的技巧,幾乎是零學習成本。
當然,體積小意味著功能相對基本:動態載入策略、循環依賴處理、複雜的套件管理這些進階議題,它不一定涵蓋。所以合理的定位是——用在中小型專案、內部工具、或想快速把散亂的 script 標籤整理成模組的既有專案上,都很合適;等到專案規模真的長大、依賴關係變複雜,再考慮遷移到完整的模組系統或原生的 ES Module 也不遲。