萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

SeaJS 入門教學(二):核心 API 與模組開發實務

安裝與引入

從 GitHub https://github.com/seajs/seajs/ 下載 sea.js(壓縮版)或 sea-debug.js,置於專案目錄,頁面以 <script src="sea.js"></script> 引入即可使用。

核心開發原則

  • 一切皆模組:每個 JS 檔案對應一個模組,類似類別概念,擁有私有/公有資料與方法。
  • 單檔一模組:一個檔案只定義一個模組。

define() 定義模組

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)。

三種模組定義模式

1. 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'; };
});

2. return 物件模式(推薦)

define(function(require) {
    var a = require('a'), b = require('b');
    return {
        data2: 2,
        func2: function() { return 'hello'; }
    };
});

3. 純資料模組簡寫

define({
    data: 1,
    func: function() { return 'hello'; }
});

模組載入與尋址

  • 絕對路徑:require("https://example/js/a") → https://example/js/a.js
  • 相對路徑:require("./c") 相對當前檔案目錄。
  • 基底路徑:非絕對且非 ./ 開頭,相對 seajs.config({base: "..."})。

自動補 .js 副檔名,除非:載入 CSS、路徑含 ?、以 # 結尾。

三種載入 API

API用途特性
seajs.use頁面入口模組靜態分析依賴,一次性載入所有
require模組內部載入依賴同步、靜態分析,路徑必須為字串字面值
require.async按需延遲載入非同步,運行時才下載

require 路徑必須為字串字面值

// 錯誤:無法靜態分析
require('module' + '1');
require('Module'.toLowerCase());

// 正確
require('./module1');

require.async 範例

require.async('./heavy-module', function(m) {
    m.doSomething();
});
copyright © 萬盛學電腦網 all rights reserved