從 GitHub https://github.com/seajs/seajs/ 下載 sea.js(壓縮版)或 sea-debug.js,置於專案目錄,頁面以 <script src="sea.js"></script> 引入即可使用。
SeaJS 來源碼顯示 define(id?, deps?, factory) 可接收 1~3 參數,但官方範例幾乎皆用單一工廠函式:
define(function(require, exports, module) {
// 模組主體
});
id:預設為檔案絕對路徑,建議不手動指定。deps:依賴陣列,建議在工廠函式內用 require() 動態載入。factory:工廠函式,接收 require, exports, module 三參數。require:載入依賴模組。exports:對外公開介面的物件。module:模組元資料(id、dependencies、exports)。define(function(require, exports, module) {
var a = require('a');
var b = require('b');
var data1 = 1; // 私有
function func1() { return a.run(data1); } // 私有
exports.data2 = 2; // 公開
exports.func2 = function() { return 'hello'; };
});
define(function(require) {
var a = require('a'), b = require('b');
return {
data2: 2,
func2: function() { return 'hello'; }
};
});
define({
data: 1,
func: function() { return 'hello'; }
});
require("https://example/js/a") → https://example/js/a.jsrequire("./c") 相對當前檔案目錄。./ 開頭,相對 seajs.config({base: "..."})。自動補 .js 副檔名,除非:載入 CSS、路徑含 ?、以 # 結尾。
| API | 用途 | 特性 |
|---|---|---|
| seajs.use | 頁面入口模組 | 靜態分析依賴,一次性載入所有 |
| require | 模組內部載入依賴 | 同步、靜態分析,路徑必須為字串字面值 |
| require.async | 按需延遲載入 | 非同步,運行時才下載 |
// 錯誤:無法靜態分析
require('module' + '1');
require('Module'.toLowerCase());
// 正確
require('./module1');
require.async('./heavy-module', function(m) {
m.doSomething();
});