DIV CSS 佈局教程網

JavaScript 封裝與作用域實戰:從踩坑到收斂的過程記錄
編輯:關於JavaScript     

寫 Web 專案的時候,總會遇到幾段邏輯需要在多個頁面共用。與其複製貼上,不如把共用的部分封裝成建構函數丟進外部 js 檔,各頁面依情境傳入不同參數。這個需求聽起來簡單,實際動手卻連續踩了三個坑,剛好把事件綁定時機、靜態與動態元素、以及變數作用域這幾件事一次講清楚。

第一版:事件完全沒反應

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

function functionTest(text) {
    var alertText = text;
    $("#btnSave").click(function (e) {
        alertTestInnert();
    });

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

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

function alertTestOuter() {
    alert(text);
}

點擊「保存」按鈕毫無反應。這是最經典的錯誤:腳本在 DOM 元素存在之前就執行完了,$("#btnSave") 抓到的是空集合,綁定自然落空。把實例化放進 $(document).ready() 之後就正常了,參數也能正確傳入。

第二版:動態產生的元素綁不上

問題接著來:頁面上有些標籤是執行期動態產生的,比如取消按鈕,對它們沒辦法用 $("#btnCancel").click() 這種靜態寫法,只能退回原生的事件屬性寫法。

於是開始試錯:

<!-- 寫法 A:只寫函數名,不帶括號 -->
<input type="button" id="btnCancel" onclick="javascript:t.AlertTest;" />

沒反應。t 是物件,指派函數本身並不會執行它。改成全域函數試試:

<!-- 寫法 B -->
<input type="button" id="btnCancel" onclick="javascript:alertTestOuter;" />

同樣沒反應,也不報錯——因為 onclick 拿到的是函數參照,瀏覽器把它當成要執行的內容卻得不到呼叫。補上一對括號之後終於動了:

<!-- 寫法 C:正確 -->
<input type="button" id="btnCancel" onclick="javascript:alertTestOuter();" />

把括號補到封裝版本上,卻跳出了新錯誤:

<input type="button" id="btnCancel" onclick="javascript:t.AlertTest();" />
Uncaught ReferenceError: t is not defined

原因在作用域:t 是用 var 宣告在 ready 回呼裡的區域變數,而 onclick 屬性中的程式碼是在全域作用域下求值的,看不到它。解法是把宣告提到外層,賦值留在裡層。

var t;                    // 宣告放在外層,全域可見
var text = "test";        // 要傳遞的參數

$(document).ready(function () {
    t = new functionTest(text);   // 賦值放在 ready 裡,確保元素已存在
});

第三版:讓取消方法也能收參數

最後一個需求是給取消動作傳入不同的值。把方法改成接受參數的形式:

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

HTML 側對應傳入即可:

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

整理後的最終結構

把通用邏輯抽到 common.js,頁面只留情境相關的部分:

頁面(htm)

<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title></title>
<script src="jquery-1.4.4.min.js" type="text/javascript"></script>
<script src="common.js" type="text/javascript"></script>
<script type="text/javascript">
    var t;                    // 必須宣告在外層,否則點擊取消時取不到
    var text = "test";        // 傳入封裝的參數

    $(document).ready(function () {
        t = new functionTest(text);   // 宣告不能寫在這裡
    });
</script>
</head>
<body>
<input type="button" id="btnSave" class="button" value="保存" />
<input type="button" id="btnCancel" class="button" value="取消" onclick="javascript:t.AlertTest('124');" />
</body>
</html>

common.js

function functionTest(text) {
    var alertText = text;

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

    // 對外暴露的方法,可從 HTML 的事件屬性呼叫
    this.AlertTest = function (text) {
        alert(text);
    };

    // 內部方法,不對外暴露
    function alertTestInnert() {
        alert(alertText);
    }
}

三個可以帶走的結論

一、DOM 相關的綁定一定要等 DOM 就緒。 不管是 ready、DOMContentLoaded 還是 defer,重點是順序不能顛倒。

二、事件屬性裡只能看見全域。 onclick="..." 中的程式碼在全域作用域求值,任何藏在函數或閉包裡的變數都摸不到;而且函數一定要帶括號呼叫,寫成 fn 只是把函數當值傳出去。

三、宣告與賦值可以分開擺。 需要跨作用域共用的物件,用「外層宣告、內層賦值」這種寫法,既保住了全域可見性,又確保了初始化時機正確。

如果重構空間允許,更現代的替代方案是用事件委派(把監聽器掛在父容器上,用 event.target 判斷來源),這樣動態產生的元素完全不需要額外處理;或者用 ES Module 匯入匯出,徹底擺脫全域變數的污染。

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