三大核心方法
| 方法 | 作用 | 參數 | 回傳值 |
.show() | 顯示隱藏元素 | duration, easing, complete | jQuery (鏈式) |
.hide() | 隱藏元素 | duration, easing, complete | jQuery |
.toggle() | 切換顯示/隱藏 | duration, easing, complete / boolean | jQuery |
基礎範例
<!DOCTYPE html>
<html>
<head>
<title>jQuery Show/Hide/Toggle</title>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
$(document).ready(function() {
$("#show").click(function() { $("p").show(); });
$("#hide").click(function() { $("p").hide(2000); }); // 2秒動畫隱藏
$("#tog").click(function() { $("p").toggle("slow"); }); // 緩慢切換
});
</script>
</head>
<body>
<button id="show">顯示</button>
<button id="hide">隱藏</button>
<button id="tog">切換</button>
<p>這是一個段落這是一個段落這是一個段落這是一個段落這是一個段落這是一個段落</p>
</body>
</html>
參數詳解
// 1. 無參數:立即顯示/隱藏
$("#el").show();
$("#el").hide();
// 2. 速度字串
$("#el").show("slow"); // 600ms
$("#el").hide("fast"); // 200ms
$("#el").toggle("normal"); // 400ms (預設)
// 3. 毫秒數
$("#el").show(300);
$("#el").hide(500);
// 4. 完整參數:速度 + 緩動函數 + 完成回呼
$("#el").show(400, "swing", function() {
console.log("顯示動畫完成");
});
// 5. toggle 傳入 boolean 強制狀態
$("#el").toggle(true); // 強制顯示 (等同 show())
$("#el").toggle(false); // 強制隱藏 (等同 hide())
底層原理
- 記錄元素原本的 `display` 值 (block/inline/inline-block/table-row 等)
- `hide()`:設定 `display: none`,並將原值存於 `data("olddisplay")`
- `show()`:恢復原 `display` 值
- 動畫過程中臨時設定 `overflow: hidden`、調整 `width`/`height`/`opacity`/`padding`/`margin`
進階應用場景
1. 手風琴選單
$(".accordion-header").click(function() {
$(this).next(".accordion-content").slideToggle(300); // 專門針對高度切換
$(this).siblings(".accordion-content").slideUp(300);
});
2. 條件式顯示
// 根據條件顯示/隱藏
$("#adminPanel").toggle(user.role === 'admin');
3. 表單驗證錯誤訊息
function showError($field, msg) {
$field.siblings(".error-msg").text(msg).show(200);
}
function clearError($field) {
$field.siblings(".error-msg").hide(200);
}
常見坑點
| 問題 | 原因 | 解決 |
| inline 元素 hide 後 show 變成 block | jQuery 預設恢復為 block | CSS 設定 `display: inline` 或用 `.css('display', 'inline')` |
| table 行/儲存格 hide 異常 | display:none 破壞表格布局 | 用 `visibility: hidden` 或 CSS class 切換 |
| 動畫中斷導致元素消失 | 未使用 .stop() | 動畫前加 `.stop(true, true)` |
現代替代:CSS Class 切換
.hidden { display: none !important; }
// JS
$("#el").toggleClass("hidden"); // 無動畫
$("#el").addClass("hidden").delay(100).queue(function() { $(this).removeClass("hidden").dequeue(); }); // 簡易延遲
掌握 `show/hide/toggle` 的動畫參數與底層機制,能靈活處理各種顯示切換需求,也是學習 jQuery 動畫系統的入門基石。