DIV CSS 佈局教程網

原生JavaScript插件開發實踐:從遮罩層談架構思維
編輯:JavaScript基礎知識     

前言

公司網站早期的實作相當混亂,各處標準不一,彈出層就是其中之一——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 讓外部主動呼叫開啟與關閉,而不僅依賴點擊。

寫出一個真正實用的插件,技術過關只是入場券,思考是否周全才是關鍵。所以這篇只能算起步,路還長。

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