toggleClass() 是 addClass() 與 removeClass() 的合體:如果元素目前沒有這個 class 就加上,已經有了就移除。這個「自動判斷並反向操作」的特性,讓它成為實作開關型互動最簡潔的工具。
<!DOCTYPE html>
<html>
<head>
<script src="js/jquery.min.js"></script>
<script>
$(document).ready(function(){
$("button").click(function(){
$("h1,h2,p").toggleClass("blue");
});
});
</script>
<style type="text/css">
.blue { color:blue; }
</style>
</head>
<body>
<h1>Heading 1</h1>
<h2>Heading 2</h2>
<p>This is a paragraph.</p>
<p>This is another paragraph.</p>
<button>Toggle class</button>
</body>
</html>
第一次點擊,所有標題與段落加上 .blue 變成藍色;再點一次全部移除,回復原色。
$(selector).toggleClass(className, switch)
側邊欄收合:
$("#menu-toggle").click(function(){
$("body").toggleClass("nav-open");
});
清單項目的選取狀態:
$("#list").on("click", "li", function(){
$(this).toggleClass("selected");
});
深色模式:
$("#theme-toggle").click(function(){
$("html").toggleClass("dark");
});
用 toggleClass 切換 class,代表所有視覺變化都集中在樣式表裡定義。這帶來三個好處:一是狀態可還原(移除 class 就完全恢復原樣,不必記住原值);二是樣式可被設計稿統一管理;三是狀態語意清楚——.selected、.nav-open 讀起來就知道代表什麼,而 css("color", "blue") 只說了「做什麼」,沒說「為什麼」。
優先權問題:若元素本來就有更高優先權的樣式(例如帶 id 的規則或 !important),加上新 class 不一定看得到效果。除錯時可用開發者工具檢查哪條規則勝出。
多元素同時切換:toggleClass 對選集合中每個元素各自獨立判斷,因此若原本狀態不一,切換後仍會不一致。若要「全部統一打勾」,應改用 addClass 或帶 switch 參數的寫法。