toggleClass() 的作用如其名:某個 class 存在就移除、不存在就加上。這讓「切換狀態」這類需求不必再寫 if-else 判斷,一個方法就能完成。
先到 jQuery 官網(https://jquery.com/)下載函式庫,建立專案並把 js 檔放進去,然後撰寫頁面。
<!DOCTYPE html>
<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; /* 清除子選單縮進 */
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 與 mouseout」。移入時 class 不存在 → toggle 加上;移出時 class 存在 → toggle 移除。不必為兩個事件各寫一份 logic,也不必在函數內判斷目前狀態。
還有個細節值得一提:範例把 padding:0 與 margin:0 同時設上,是因為不同瀏覽器對 ul 縮排的預設實作不一樣——有的用 padding、有的用 margin,兩個都清才是真正把縮進歸零。註解裡也標明了哪些版本需要哪一項,這種實測記錄很有參考價值。
如果目的只是「滑過換色」,其實不需要 JavaScript。用 CSS 虛擬類別即可:
li:hover {
background: #f00;
color: #fff;
}
這麼做有三個好處:不必載入 jQuery、效能更好(不觸發 JS 執行)、在 JavaScript 被停用時仍然有效。jQuery 的 toggleClass 真正值得使用的場合,是「切換的條件不只是滑鼠」的時候,例如點擊展開面板、依資料狀態切換樣式、多個 class 一併切換等。
toggleClass 也支援一次切換多個 class,並可傳第二個布林參數強制指定狀態:
$("li").toggleClass("bg active"); // 兩個一起切換
$("li").toggleClass("bg", isSelected); // true 一律加、false 一律移除
第二個參數在「狀態由外部資料決定」時特別好用,可以少寫一個 if 分支。