toggle() 是 jQuery 裡最容易被誤解的函式之一,因為它其實有三種完全不同的行為。本文先釐清差異,再示範如何用它做出透明度切換的效果。
不帶參數時,toggle() 會檢查元素的目前狀態:可見就改為隱藏,隱藏就改為可見。
<p>Hello</p><p style="display: none">Hello Again</p>
$("p").toggle();
// 結果:第一段被隱藏,第二段顯示
// <p style="display: none">Hello</p><p style="display: block">Hello Again</p>
$("#box").toggle(600); // 600 毫秒內完成收放
$("#box").toggle(true); // 強制顯示
$("#box").toggle(false); // 強制隱藏
傳入布林值可以直接指定結果狀態,不必依賴目前狀態,這在動畫中途被打斷時特別有用。
toggle(fn1, fn2, ...) 會為元素掛上 click 事件,每次點擊輪替執行下一個函式。以下範例搭配背景圖片,示範如何讓同一張圖在點擊時於半透明與不透明之間切換:
<style type="text/css">
body { background: url(bg.jpg); margin: 20px; padding: 0; }
img { border: 1px solid #FFFFFF; }
</style>
<script src="jquery.min.js"></script>
<script>
$(function () {
$("img").toggle(
function (oEvent) {
$(oEvent.target).css("opacity", "0.5");
},
function (oEvent) {
$(oEvent.target).css("opacity", "1.0");
}
);
});
</script>
<body><img src="test.jpg"></body>
回呼函式收到的 oEvent 是原生事件物件,用 oEvent.target 就能拿到被點擊的元素;在這個例子中也可以直接寫 $(this),效果相同。
要讓 IE8 以下的舊瀏覽器也支援,可改用 filter: alpha(opacity=50),或直接用 jQuery 的 fadeTo():
$("img").toggle(
function () { $(this).fadeTo(400, 0.5); },
function () { $(this).fadeTo(400, 1.0); }
);
toggle(fn, fn) 這種「函式輪替」的形式在 jQuery 1.9 中被標記為弃用,並在後續版本移除。若維護舊專案時遇到,建議改用明確的狀態旗標:
var active = false;
$("img").on("click", function () {
active = !active;
$(this).css("opacity", active ? "0.5" : "1.0");
});
這樣的寫法行為完全可控,也不必依賴已被移除的 API。