前陣子寫一個小範例時踩到頗典型的坑:原本想讓同一個按鈕在數個事件之間輪流切換,結果畫面上的元素直接消失不見。翻查 jQuery 官方 API 文件後才恍然大悟——問題不在我的邏輯,而在版本。
早期的 jQuery 裡其實有兩個同名方法,用途完全不同:
.toggle( handler(eventObject), handler(eventObject)[, handler(eventObject) ] ) // 為符合的元素綁定兩個以上的處理函式,於連續點擊時輪流執行 .toggle( [duration ] [, complete ] ) // 顯示或隱藏符合的元素
前者負責「事件交替」,後者負責「顯示/隱藏」。同名不同命,本身就容易誤用。
官方文件的 Note 寫得很明白:事件簽名(method signature)在 jQuery 1.8 被標記為 deprecated,並在 1.9 正式移除。剩下的只有動畫版本的 .toggle()。也就是說,當你把兩個 function 傳進 toggle(),jQuery 不再把它當成事件綁定,而是走了顯示/隱藏那條路,元素自然就被藏起來了。
既然官方把功能拿掉,需求還是要自己補。最直白的做法是用 click 事件搭配一個計數變數:
var num = 0;
$('#button').click(function (e) {
if (num++ % 2 === 0) {
// 第一次、第三次…要做的事
} else {
// 第二次、第四次…要做的事
}
e.preventDefault(); // 阻止元素預設行為(若有)
});
取餘數的寫法可以很輕鬆擴充到「三個事件輪流」,只要把 2 換成 3、再用 switch 分派即可。另一種思路是在 click 裡讀取某個狀態(例如目前是編輯或檢視模式)再決定分支,適合行為數量較多、語意較重的情境。
小結:遇到版本升級後行為跑掉,先查 API 文件裡的 deprecated / removed 標註,往往比對著自己的程式碼找 bug 快得多。