想把一段共用的 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 外面,賦值才放在裡面。這個區分在下一個坑會變成關鍵。
靜態寫在 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:
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 把整個模組包起來,只對外暴露需要的介面。