DIV CSS 佈局教程網

jQuery toggle() 方法用法整理:切換元素的可見狀態
編輯:JQuery常見問題     

toggle() 顧名思義就是「翻面」:元素目前可見就把它藏起來,目前隱藏就把它顯示出來。它是實作折疊區塊、顯示更多、明暗主題切換時最順手的一支方法。

語法與參數

$(selector).toggle(speed, callback, switch)

speed(選填)

控制顯示到隱藏(或反向)的速度,預設為 0,也就是瞬間切換。可用值包括毫秒數(如 1500)與 "slow"、"normal"、"fast" 三個關鍵字。設定速度後,元素在過程中會逐漸改變高度、寬度、内外邊距與透明度。使用 speed 時就不能再搭配 switch 參數。

callback(選填)

動畫結束後要執行的函式。除非有設定 speed,否則無法使用這個參數。常見用途是在收合後把焦點移回觸發鈕,或更新 aria 屬性。

switch(選填)

布林值,用來強制指定結果而非翻轉現況:true 顯示所有選到的元素、false 隱藏它們。使用這個參數時,speed 與 callback 都無法搭配。

補充一點:toggle() 作用的是那些「被 jQuery 隱藏」或「在 CSS 中宣告 display:none」的元素。以 visibility:hidden 隱藏的元素不在適用範圍內。

三個由簡到繁的範例

範例一:最基礎的切換

一個按鈕搭配兩段文字,其中一段先隱藏,點擊後兩者一起翻面:

$("button").click(function () {
  $("p").toggle();
});

看效果。

範例二:加上速度

把速度設為 "slow",切換過程會有一段高度收放的動畫,視覺上更容易理解「內容是從哪來的」:

$("button").click(function () {
  $("p").toggle("slow");
});

看效果。

範例三:用 switch 明確控制

以一個遞增的旗標決定每次點擊要顯示還是隱藏,適合需要與其他狀態同步的情況:

var flip = 0;
$("button").click(function () {
  $("p").toggle(flip++ % 2 == 0);
});

看效果。

相關方法怎麼挑

  • show()/hide():明確指定要顯示或隱藏,語意最清楚,也支援速度與 callback。
  • slideToggle():以高度收放呈現,適合區塊型內容。
  • fadeToggle():以透明度變化呈現,適合浮層與提示。
  • toggleClass():切換的是 class 而非可見性,樣式變化更自由,通常比直接操作 style 好維護。

實際開發時,若「目前的狀態」已經能從資料或 class 得知,直接使用 show()/hide() 往往比 toggle() 更不容易出錯——因為翻轉式 API 的結果取決於當下狀態,一旦狀態被別處改動,行為就變得難以預測。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved