DIV CSS 佈局教程網

從踩坑到通:JavaScript 封裝與作用域的實戰記錄
編輯:JavaScript綜合知識     

想把一段共用的 JS 邏輯包成一個「物件」,讓不同頁面傳入不同參數——聽起來簡單,實際寫起來卻會接連撞上四個問題:事件沒綁上、變數存取不到、參數傳不進去、動態產生的元素無法響應。這篇把整個過程完整記錄下來。

起點:最直覺的封裝寫法

var text = "test";
var t = new functionTest(text);

function functionTest(text) {
    var alertText = text;

    $("#btnSave").click(function (e) {
        alertTestInner();
    });

    this.AlertTest = function () {
        alert(alertText);
    };

    function alertTestInner() {
        alert(alertText);
    }
}

function alertTestOuter() {
    alert(text);
}

這裡有兩個層次的方法:this.AlertTest 是公開的,可以從外部呼叫;alertTestInner 沒有掛在 this 上,屬於函式內部的私有方法。這種「公開 API + 私有實作」的區分,正是封裝的核心價值。

坑一:點擊沒反應

把 $("#btnSave").click(...) 寫在文件頂層,元素可能還沒被解析到, therefore 事件綁定失敗。這是最經典的錯誤——事件綁定必須等 DOM 就緒:

var text = "test";
var t;

$(document).ready(function () {
    t = new functionTest(text);
});

順帶記下:變數 t 的宣告要放在 ready 外面,賦值才放在裡面。這個區分在下一個坑會變成關鍵。

坑二:onclick 裡找不到 t

靜態寫在 HTML 上的按鈕沒問題,但頁面若會動態產生元素,就無法用 jQuery 事先綁定,只能寫行內的 onclick:

<input type="button" id="btnCancel" value="取消"
       onclick="javascript:t.AlertTest();" />

這時瀏覽器丟出 Uncaught ReferenceError: t is not defined。原因正是作用域:t 原本是宣告在 $(document).ready() 回呼函式裡的區域變數,而 onclick 屬性的程式碼是在全域作用域下被編譯與執行的,看不到那個區域變數。把宣告提到外層、只把賦值留在 ready 裡,問題就解決了。

坑三:少了那對括號

過程中還遇到另一個狀況:寫成 onclick="javascript:alertTestOuter;" 完全沒反應,也不報錯。原因是這只是在 onclick 的程式碼區塊裡「求值一個函式參照」,並沒有呼叫它。加上括號才會真的執行:

onclick="javascript:alertTestOuter();"

這個區別在 jQuery 裡不明顯(.click(fn) 傳的是參照,由 jQuery 負責呼叫),但寫行內 onclick 時就必須自己補上。

坑四:參數怎麼傳進去

讓公開方法接受參數:

this.AlertTest = function (msg) {
    alert(msg);
};

HTML 端直接寫入實參:

<input type="button" id="btnCancel" value="取消"
       onclick="javascript:t.AlertTest('124');" />

最終整理:共用邏輯抽到 common.js

common.js:

function functionTest(text) {
    var alertText = text;

    $("#btnSave").click(function (e) {
        alertTestInner();
    });

    this.AlertTest = function (msg) {
        alert(msg);
    };

    function alertTestInner() {
        alert(alertText);
    }
}

頁面:

<script src="jquery.min.js" type="text/javascript"></script>
<script src="common.js" type="text/javascript"></script>
<script type="text/javascript">
var t;              // 必須宣告在外層,onclick 才存取得到
var text = "test";  // 傳入共用模組的參數

$(document).ready(function () {
    t = new functionTest(text);   // 賦值放在 ready 裡
});
</script>

<input type="button" id="btnSave" value="保存" />
<input type="button" id="btnCancel" value="取消"
       onclick="javascript:t.AlertTest('124');" />

如果重寫一次,我會怎麼做

上面這套能動,但有幾處可以更好。第一,行內 onclick 在多人協作時容易出錯,若元素是動態產生的,改用事件委派會乾淨得多:

$(document).on("click", "#btnCancel", function () {
    t.AlertTest($(this).data("id"));
});

這樣就不必依賴全域變數,參數也可以透過 data-* 屬性帶入。第二,用 new 呼叫一個匿名函式雖然可行,但語意不清晰;直接寫 var t = functionTest(text) 效果相同且更直觀。第三,若要避免污染全域,可以用 IIFE 或 ES Module 把整個模組包起來,只對外暴露需要的介面。

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