寫 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 匯入匯出,徹底擺脫全域變數的污染。