這份整理聚焦 Sea.js 在實際開發中最常用的配置與 API,適合快速查閱。Sea.js 以 CMD 規範為核心,讓 JavaScript 模組的撰寫與載入更接近 Node.js 的直覺方式。
Sea.js 強調簡單、自然的程式組織方式。開發者可以透過統一的模組定義規範管理依賴,不必手動維護大量腳本載入順序。它同時提供常用插件與擴充介面,方便進行除錯與效能優化。
alias 可為常用模組設定易記的名稱,之後就能以別名載入。
seajs.config({
alias: {
jquery: 'jquery/jquery/1.10.1/jquery'
}
});
define(function(require, exports, module) {
var $ = require('jquery');
});paths 可將某個目錄映射為簡短名稱,適合跨目錄管理資源。
seajs.config({
paths: {
gallery: 'https://a.alipayobjects.com/gallery'
},
alias: {
underscore: 'gallery/underscore'
}
});當模組路徑需要在執行階段決定時,可使用 vars。模組識別字中可用大括號表示變數。
seajs.config({
vars: {
locale: 'zh-cn'
}
});
var lang = require('./i18n/{locale}.js');map 可用於路徑轉換,例如除錯版本切換。
seajs.config({
map: [
['.js', '-debug.js']
]
});preload 可在一般模組載入前,先載入指定模組。空字串會被忽略。此設定通常要等到 use 時才會生效。
seajs.config({
preload: 'a'
});
seajs.use('./b');debug 為 true 時,載入器不會刪除動態插入的 script 標籤,方便除錯。base 是 Sea.js 解析頂級識別字時的基準路徑,一般建議透過目錄結構自然安排,而不是頻繁修改 base。charset 可指定腳本或樣式載入時的字元編碼,也可寫成函式依需求判斷。
seajs.use 用於載入一個或多個模組,並可在載入完成後執行回呼。
seajs.use('./a', function(a) {
a.doSomething();
});
seajs.use(['./a', './b'], function(a, b) {
a.doSomething();
b.doSomething();
});需要注意,seajs.use 與 DOM ready 沒有直接關係。若要在 DOM 就緒後執行初始化,仍需搭配 jQuery 等工具或自行處理 DOM 狀態。
seajs.cache 可檢視目前模組系統中的模組資訊。seajs.resolve 可解析模組識別字對應的最終路徑,常用於除錯與插件開發。seajs.data 則可查看 Sea.js 設定與內部狀態,便於排查問題。
Sea.js 的識別字可分為相對識別字與頂級識別字。以點開頭者為相對識別字,會相對於目前模組解析;一般字串則為頂級識別字,會相對於 base 解析。理解 base 的意義,是掌握 Sea.js 路徑規則的關鍵。