toggleClass() 的作用一句話就能講完:有這個 class 就加上,沒有就移除。它最適合處理「同一個事件處理器負責移入與移出」這種情境,能省掉一個 if 判斷。
先到 jQuery 官網(jquery.com)下載函式庫,建立專案後把檔案放進專案的 js 目錄,然後在頁面中引入。
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"https://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<script type="text/javascript" src="js/jquery-1.10.2.js"></script>
<title>toggleClass 示範</title>
<style type="text/css">
.bg {
background: #f00; /* 背景顏色 */
color: #fff; /* 文字顏色 */
width: 80px;
}
ul, li { list-style: none; } /* 清掉 ul 與 li 預設的項目符號 */
ul {
padding: 0; /* IE8/IE9/Firefox 有效 */
margin: 0; /* 加上這行後各瀏覽器都正常 */
}
</style>
<script type="text/javascript">
$(function () {
// 同一個函式同時綁到移入與移出
$("li").mouseover(setColor).mouseout(setColor);
function setColor() {
// 存在就移除、不存在就加上
$(this).toggleClass("bg");
}
});
</script>
</head>
<body>
<div id="div">
<ul>
<li>橫向選單1</li>
<li>橫向選單2</li>
<li>橫向選單3</li>
<li>橫向選單4</li>
<li>橫向選單5</li>
<li>橫向選單6</li>
</ul>
</div>
</body>
</html>
關鍵就在那兩行:mouseover 時加上 bg,mouseout 時同樣呼叫這個函式,偵測到已有 bg 就移除。一個函式解決兩個方向,程式碼減半。
範例註解裡提到「padding 在 IE6/IE7 無效,加上 margin 就都可以了」,這是那個年代處理清單縮排的標準手法。今天所有瀏覽器都支援 padding: 0,只要再加上 list-style: none 即可,不必兩個都寫。
如果只想處理「移入加上、移出移除」,用 hover() 傳兩個函式其實語意更清楚:
$("li").hover(
function () { $(this).addClass("bg"); },
function () { $(this).removeClass("bg"); }
);
而 toggleClass 真正無可取代的場合,是「點擊切換」這類需要狀態反轉的互動:
$(".panel").on("click", function () {
$(this).toggleClass("expanded"); // 每次點擊在展開/收合之間反轉
});
另外補充一個實務技巧:toggleClass 可以一次傳多個 class 名稱(jQuery 1.4+),也能傳函式依當前狀態動態決定要套用的類別。而現代寫法若不需要 jQuery,element.classList.toggle('bg') 就是原生等效 API,而且還能傳第二個參數強制指定狀態:classList.toggle('bg', shouldShow)。
最後提醒:純視覺的 hover 效果,用 CSS 的 li:hover { background: #f00; } 一行就能完成,不必動用 JavaScript。JavaScript 版本只有在切換的依據不是「滑鼠狀態」時(例如依資料內容決定要不要高亮)才有必要。