toggle 是 jQuery 中最容易讓人「攪在那裡」的函式,因為它同名卻有幾種完全不同的行為。本文透過一個漸進的實作過程,把每個階段的意圖與陷阱都攤開來看。
它的作用是輪替執行多個函式:第一次觸發跑第一個,第二次跑第二個,第三次又回到第一個,以此循環。典型用途是「點一次變藍、再點一次變黑」。
先把 HTML 與初始樣式準備好:
<body>
<input type="button" id="btnShow" value="Toggle"/>
<div id="DivToggle">此處顯示 id "DivToggle" 的內容</div>
</body>
#DivToggle {
height: 150px;
width: 200px;
margin: 50px;
background-color: #6CC;
}
不帶參數的 toggle() 用來切換可見狀態——顯示的變隱藏,隱藏的變顯示。
$(function () {
$("#btnShow").click(function (event) {
$("#DivToggle").toggle();
});
});
點一次隱藏,再點一次顯示,不斷循環。
$("#DivToggle").toggle(true); // 顯示
$("#DivToggle").toggle(false); // 隱藏
$("#DivToggle").toggle(600); // 600 毫秒的動畫切換
傳布林值可以直接指定結果,不必依賴目前狀態。這在動畫進行中被打斷時特別有用,因為此時「目前狀態」是模糊的。
滑鼠移上去顯示、移開隱藏,是常見的互動模式。這裡用到 hover(fnOver, fnOut),兩個參數分別是移入與移出的處理函式:
$(function (event) {
$("#btnShow").hover(OverOut, OverOut);
function OverOut(event) {
$("#DivToggle").toggle(600);
}
});
把 toggle(600) 抽成一個具名函式再傳進去,可讀性比寫兩次匿名函式好得多。
直覺上我們會想這樣寫:
$(function (event) {
function OverOut(event) { $("#DivToggle").toggle(600); }
$("#DivToggle").toggle(
function () { $("#btnShow").click(OverOut); },
function () { $("#btnShow").click(OverOut); }
);
});
回頭看這段程式碼其實是很有問題的——但居然也能跑出想要的結果。問題在於 toggle(fn, fn) 本身就是為指定元素掛上 click 事件,然後在該元素上輪替呼叫那些函式。而這裡的函式內容卻是「去幫 btnShow 綁定 click」,等於把事件綁定動作寫進了事件處理器裡,每次點擊都會重複綁一次。它能運作純粹是因為瀏覽器容許重複綁定,實際上事件被掛了無數次。
另一種嘗試是這樣:
$("#DivToggle").toggle(
function () { $(this).click(function () { $(this).css("background", "Blue"); }); },
function () { $(this).click(function () { $(this).css("background", "Green"); }); }
);
同樣的毛病:toggle 的函式裡又嵌了一層 click 綁定,層層遞迴,思緒就跟著打結了。
想通了之後,答案其實很單純——把輪替的邏輯直接掛在觸發者(按鈕)身上,而不是繞一圈回到自己:
$(function (event) {
function OverOut(event) {
$("#DivToggle").toggle(600);
}
$("#btnShow").toggle(
OverOut,
OverOut,
function () { $("#DivToggle").css({ "background": "Green" }); },
function () { $("#DivToggle").css({ "background": "Blue" }); }
);
});
四個函式的意義是:第一次點擊播放 toggle 動畫、第二次再播放一次、第三次把背景變綠、第四次變藍,第五次回到起點。這才是 toggle(fn, fn, ...) 的正確使用方式。
這段摸索過程的價值不在 toggle 本身,而在它揭露的一個常見誤區:不要把「綁定事件」寫在「事件處理器」裡面。事件綁定應該在初始化階段一次完成,處理器裡只該放「要做的事」。一旦搞混這兩層,就會出現事件被重複掛載、觸發次數成倍成長這類難以察覺的 bug。
另外要補充的是,toggle(fn, fn) 這種函式輪替形式在 jQuery 1.9 中已被弃用並在後續版本移除。現代寫法應改用明確的狀態旗標:
var step = 0;
var actions = [
function () { $("#DivToggle").toggle(600); },
function () { $("#DivToggle").css("background", "Green"); },
function () { $("#DivToggle").css("background", "Blue"); }
];
$("#btnShow").on("click", function () {
actions[step % actions.length]();
step++;
});
行為完全等價,但不依賴任何已移除的 API,而且每一步在做什麼一目了然。