使用 SeaJS(本文版本為 2.1.1)進行模組化開發時,常需把 jQuery 本身、自訂類別與外掛都封裝成標準模組。本文分三部分完整示範。
用 define 包住 jQuery 原始碼,並以 $.noConflict() 回傳,避免污染全域:
define(function () {
// 這裡放置 jquery 程式碼
return $.noConflict();
});
使用時以 require 引入即可一如往常地使用:
define(function (require, exports, module) {
var $ = require('./js/jquery');
// $(...).wyhinterlaced(...);
});
將時間格式化、日期計算等工具函式寫入模組,最後用 exports 逐一導出:
define(function (require, exports, module) {
var $ = require("../js/jquery");
function GetTime(arg){ /* ...時間格式化... */ }
function GetYear(){ var t=new Date(); return t.getFullYear(); }
// 其餘 GetMonth、GetDay、GetHours... 略
exports.GetTime = GetTime;
exports.GetYear = GetYear;
/* 其餘導出... */
});
呼叫時引入模組後即可使用其方法:
define(function (require, exports, module) {
var a = require('./js/time');
alert(a.GetTime(3));
});
外掛封裝的關鍵是讓 define 回傳一個接收 jQuery 的函式,在其中以 (function($){ ... })(jquery) 的形式擴充 $.fn:
define(function (require, exports, moudles) {
return function (jquery) {
(function ($) {
$.fn.wyhhover = function (options) { /* 當前行高亮 */ };
$.fn.wyhinterlaced = function (options) { /* 奇偶行不同底色 */ };
})(jquery);
}
});
使用時以「共享」方式把外掛掛到 jQuery 上,再於 ready 中呼叫:
define(function (require, exports, module) {
var $ = require('./js/jquery');
require('./js/jquery_tr')($); // 共享給 jquery
$(document).ready(function () {
$("tr").wyhinterlaced({ "odd": "red", "even": "blue" });
$("tr").wyhhover();
});
});
掌握這三種封裝模式,就能在 SeaJS 的模組化體系中,順暢地整合 jQuery 生態系的所有資源。