DIV CSS 佈局教程網

Sea.js 模組化開發速查:從配置到模組載入
編輯:關於JavaScript     

這份整理聚焦 Sea.js 在實際開發中最常用的配置與 API,適合快速查閱。Sea.js 以 CMD 規範為核心,讓 JavaScript 模組的撰寫與載入更接近 Node.js 的直覺方式。

Sea.js 的核心價值

Sea.js 強調簡單、自然的程式組織方式。開發者可以透過統一的模組定義規範管理依賴,不必手動維護大量腳本載入順序。它同時提供常用插件與擴充介面,方便進行除錯與效能優化。

常用配置

alias:模組別名

alias 可為常用模組設定易記的名稱,之後就能以別名載入。

seajs.config({
  alias: {
    jquery: 'jquery/jquery/1.10.1/jquery'
  }
});

define(function(require, exports, module) {
  var $ = require('jquery');
});

paths:路徑別名

paths 可將某個目錄映射為簡短名稱,適合跨目錄管理資源。

seajs.config({
  paths: {
    gallery: 'https://a.alipayobjects.com/gallery'
  },
  alias: {
    underscore: 'gallery/underscore'
  }
});

vars:變數配置

當模組路徑需要在執行階段決定時,可使用 vars。模組識別字中可用大括號表示變數。

seajs.config({
  vars: {
    locale: 'zh-cn'
  }
});

var lang = require('./i18n/{locale}.js');

map:路徑映射

map 可用於路徑轉換,例如除錯版本切換。

seajs.config({
  map: [
    ['.js', '-debug.js']
  ]
});

preload:預先載入

preload 可在一般模組載入前,先載入指定模組。空字串會被忽略。此設定通常要等到 use 時才會生效。

seajs.config({
  preload: 'a'
});

seajs.use('./b');

debug、base 與 charset

debug 為 true 時,載入器不會刪除動態插入的 script 標籤,方便除錯。base 是 Sea.js 解析頂級識別字時的基準路徑,一般建議透過目錄結構自然安排,而不是頻繁修改 base。charset 可指定腳本或樣式載入時的字元編碼,也可寫成函式依需求判斷。

常用方法

seajs.use

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

seajs.cache 可檢視目前模組系統中的模組資訊。seajs.resolve 可解析模組識別字對應的最終路徑,常用於除錯與插件開發。seajs.data 則可查看 Sea.js 設定與內部狀態,便於排查問題。

模組識別字與路徑

Sea.js 的識別字可分為相對識別字與頂級識別字。以點開頭者為相對識別字,會相對於目前模組解析;一般字串則為頂級識別字,會相對於 base 解析。理解 base 的意義,是掌握 Sea.js 路徑規則的關鍵。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved