公司網站早期的實作相當混亂,各處標準不一,彈出層就是其中之一——UI 換了幾任,每個人做出來的風格都不同。最近開始正視這個問題,既然要統一,就該做成一個可重複使用的模組。我選擇寫成插件,寫完之後發現其中有幾個思路值得記錄,於是有了這篇整理。
對「架構」這個詞我接觸不算多,目前的理解是:架構就是為未來可能發生的事預留空間。
以前也封裝過插件,但後端同事嫌難用。檢討後找到原因:該暴露的介面沒暴露,不該要求傳的參數反而強制要傳。前者是因為我沒有站在使用者的角度思考,寫出來的東西自然只能當一次性用品。
所以現在動手之前,我會先想清楚幾件事:這個插件需要哪些參數?哪些是必填、哪些可選?哪些功能以後可能擴充?哪些設定日後可能變動?把這些想過一遍,寫出來的東西才不會到處是坑。
;(function (window, document) {
var MaskShare = function () {};
MaskShare.prototype = {};
window.MaskShare = MaskShare;
}(window, document));
把程式碼包進自執行函數,避免變數污染全域;再把構造函數掛到 window 上,讓外部可以取用。
功能很單純:點擊某個元素彈出遮罩層,再點遮罩層將它關掉。
由此至少可以推出一個必要參數——點誰觸發;此外還需要一組可覆寫的預設設定。

;(function (window, document) {
var MaskShare = function (targetDom, options) {
// 同時支援 new MaskShare("dom") 與 MaskShare("dom")
if (!(this instanceof MaskShare)) return new MaskShare(targetDom, options);
// 參數合併:把預設值攤開後讓外部設定覆寫
// imgSrc 日後可能調整,因此開放給外部指定
this.options = this.extend({
imgSrc: "../static/img/coupon-mask_1.png"
}, options);
// 目標元素:同時接受選擇器字串與 DOM 物件
if ((typeof targetDom) === "string") {
this.targetDom = document.querySelector(targetDom);
} else {
this.targetDom = targetDom;
}
var boxDom = document.createElement("div");
var imgDom = document.createElement("img");
// 預設樣式。z-index 給大一些,避免被其他元素蓋掉
boxDom.style.cssText = "display: none;position: absolute;left: 0;top: 0;" +
"width: 100%;height:100%;background-color: rgba(0,0,0,0.8);z-index:9999;";
imgDom.style.cssText = "margin-top:20px;width: 100%;";
// 允許外部覆寫樣式
if (this.options.boxDomStyle) { this.setStyle(boxDom, this.options.boxDomStyle); }
if (this.options.imgDomStyle) { this.setStyle(imgDom, this.options.imgDomStyle); }
imgDom.src = this.options.imgSrc;
boxDom.appendChild(imgDom);
this.boxDom = boxDom;
this.init();
};
MaskShare.prototype = {
init: function () {
this.event();
},
// 淺合併
extend: function (obj, obj2) {
for (var k in obj2) { obj[k] = obj2[k]; }
return obj;
},
// 批次設定樣式
setStyle: function (dom, objStyle) {
for (var k in objStyle) { dom.style[k] = objStyle[k]; }
},
event: function () {
var _this = this;
// 點擊目標元素 → 開啟遮罩
this.targetDom.addEventListener("click", function () {
document.body.appendChild(_this.boxDom);
_this.boxDom.style.display = "block";
_this.options.open && _this.options.open();
}, false);
// 點擊遮罩 → 關閉
this.boxDom.addEventListener("click", function () {
this.style.display = "none";
_this.options.close && _this.options.close();
}, false);
}
};
window.MaskShare = MaskShare;
}(window, document));
MaskShare(".immediately", {
imgSrc: "../static/img/loading_icon.gif",
boxDomStyle: { opacity: ".9" },
imgDomStyle: { opacity: ".8" },
open: function () { console.log("show"); },
close: function () { console.log("close"); }
});
回頭再看,這個版本仍有明顯局限。最直接的問題是:如果內容不是圖片,而是一段文字或一個自訂 DOM 呢?目前的實作把 imgDom 寫死了,無法替換。
其他可以改進的方向還包括:暴露 destroy() 方法以便銷毀並移除事件綁定;用 Object.assign 取代手寫的淺合併;把遮罩層定位從 absolute 改為 fixed(目前版本在頁面可滾動時會有問題);以及提供 API 讓外部主動呼叫開啟與關閉,而不僅依賴點擊。
寫出一個真正實用的插件,技術過關只是入場券,思考是否周全才是關鍵。所以這篇只能算起步,路還長。