toggle() 顧名思義就是「翻面」:元素目前可見就把它藏起來,目前隱藏就把它顯示出來。它是實作折疊區塊、顯示更多、明暗主題切換時最順手的一支方法。
$(selector).toggle(speed, callback, switch)
控制顯示到隱藏(或反向)的速度,預設為 0,也就是瞬間切換。可用值包括毫秒數(如 1500)與 "slow"、"normal"、"fast" 三個關鍵字。設定速度後,元素在過程中會逐漸改變高度、寬度、内外邊距與透明度。使用 speed 時就不能再搭配 switch 參數。
動畫結束後要執行的函式。除非有設定 speed,否則無法使用這個參數。常見用途是在收合後把焦點移回觸發鈕,或更新 aria 屬性。
布林值,用來強制指定結果而非翻轉現況:true 顯示所有選到的元素、false 隱藏它們。使用這個參數時,speed 與 callback 都無法搭配。
補充一點:toggle() 作用的是那些「被 jQuery 隱藏」或「在 CSS 中宣告 display:none」的元素。以 visibility:hidden 隱藏的元素不在適用範圍內。
一個按鈕搭配兩段文字,其中一段先隱藏,點擊後兩者一起翻面:
$("button").click(function () {
$("p").toggle();
});
看效果。
把速度設為 "slow",切換過程會有一段高度收放的動畫,視覺上更容易理解「內容是從哪來的」:
$("button").click(function () {
$("p").toggle("slow");
});
看效果。
以一個遞增的旗標決定每次點擊要顯示還是隱藏,適合需要與其他狀態同步的情況:
var flip = 0;
$("button").click(function () {
$("p").toggle(flip++ % 2 == 0);
});
看效果。
show()/hide():明確指定要顯示或隱藏,語意最清楚,也支援速度與 callback。slideToggle():以高度收放呈現,適合區塊型內容。fadeToggle():以透明度變化呈現,適合浮層與提示。toggleClass():切換的是 class 而非可見性,樣式變化更自由,通常比直接操作 style 好維護。實際開發時,若「目前的狀態」已經能從資料或 class 得知,直接使用 show()/hide() 往往比 toggle() 更不容易出錯——因為翻轉式 API 的結果取決於當下狀態,一旦狀態被別處改動,行為就變得難以預測。