基礎顯示/隱藏
// 立即隱藏/顯示 (無動畫)
$("#element").hide();
$("#element").show();
// 帶速度參數 (毫秒或關鍵字)
$("#element").hide(300); // 300ms 漸隱
$("#element").show("fast"); // 200ms 漸顯
$("#element").hide("slow"); // 600ms 漸隱
// 回調函式
$("#element").hide(300, function() {
console.log("隱藏完成");
});
toggle() 切換顯示狀態
// 切換:顯示→隱藏、隱藏→顯示
$("#btn").click(function() {
$("#element").toggle(300);
});
// 等同於
if ($("#element").is(":visible")) {
$("#element").hide(300);
} else {
$("#element").show(300);
}
淡入淡出動畫
// 淡入 (透明度 0 → 1)
$("#element").fadeIn(400);
$("#element").fadeIn("fast", function() { /* 完成回調 */ });
// 淡出 (透明度 1 → 0)
$("#element").fadeOut(400);
// 切換淡入/淡出
$("#element").fadeToggle(400);
// 淡至指定透明度
$("#element").fadeTo(400, 0.5); // 透明度 50%
滑動動畫
// 向下滑開 (顯示)
$("#element").slideDown(400);
// 向上滑合 (隱藏)
$("#element").slideUp(400);
// 切換滑動
$("#element").slideToggle(400);
自訂動畫 .animate()
$("#element").animate({
opacity: 0.5,
height: "toggle", // 或具體數值 "200px"
width: "300px",
marginLeft: "50px"
}, {
duration: 1000, // 毫秒
easing: "swing", // "linear" | "swing" (預設)
complete: function() { console.log("動畫完成"); },
step: function(now, fx) { /* 每幀回調 */ },
queue: true // 是否進入動畫佇列
});
// 停止動畫
$("#element").stop(); // 停止當前動畫
$("#element").stop(true); // 清除佇列 + 停止當前
$("#element").stop(true, true); // 清除佇列 + 跳至當前動畫結束狀態
$("#element").stop(false, true); // 保留佇列 + 跳至當前動畫結束狀態
動畫佇列控制
// 預設:動畫進入佇列依序執行
$("#elem").slideUp(300).fadeIn(300).slideDown(300);
// 並行執行:queue: false
$("#elem").animate({left: 100}, {duration: 500, queue: false})
.animate({top: 100}, {duration: 500, queue: false});
// 手動控制佇列
$("#elem").queue(function(next) {
console.log("自訂佇列步驟");
next(); // 必須呼叫 next() 繼續下一個
}).fadeIn(300);
CSS 類別切換動畫 (現代推薦)
<style>
.box {
width: 100px; height: 100px; background: #3498db;
transition: all 0.3s ease; /* CSS 過渡動畫 */
}
.box.hidden {
opacity: 0;
transform: scale(0.8);
pointer-events: none;
}
</style>
<script>
// 僅切換 class,動畫由 CSS 處理 (效能更好、可硬體加速)
$("#toggleBtn").click(function() {
$(".box").toggleClass("hidden");
});
</script>
顯示/隱藏狀態判斷
// jQuery
$("#elem").is(":visible"); // true/false
$("#elem").is(":hidden"); // true/false
// 原生
element.offsetParent !== null; // 粗略判斷
getComputedStyle(element).display !== 'none'; // 較準確
element.checkVisibility(); // 現代 API (Chrome 114+)
常見坑點與解決
| 問題 | 原因 | 解決 |
| 動畫完成後 layout 突變 | display:none 移除佔位空間 | 用 opacity:0 + visibility:hidden 代替 |
| 快速點擊導致動畫疊加 | 動畫佇列堆疊 | .stop(true, true) 或旗標鎖定 |
fadeIn 後元素仍不可點擊 | 父元素 display:none 或 z-index 問題 | 檢查父層級可見度與層疊上下文 |
表格列 slideUp 無效 | <tr> 不支援 overflow hidden | 包裹 <div> 或用 fadeOut |
現代最佳實踐建議
- 優先用 CSS Transition/Animation:效能佳 (GPU 加速)、可維護、無 JS 阻塞
- 簡單切換用
classList.toggle():el.classList.toggle('hidden')
- 複雜序列動畫用 Web Animations API:
el.animate(keyframes, options)
- 需 JS 協調時:
requestAnimationFrame 或 GSAP 等專業動畫庫
- jQuery 動畫:維護舊專案、簡單需求、快速原型
速查表
| 需求 | jQuery 方法 | CSS 替代 |
| 顯示/隱藏切換 | .toggle() | .classList.toggle('show') |
| 淡入/淡出 | .fadeIn()/.fadeOut() | opacity + transition |
| 滑動展開/收合 | .slideDown()/.slideUp() | max-height + transition |
| 自訂屬性動畫 | .animate() | @keyframes / WAAPI |
| 停止所有動畫 | .stop(true, true) | animation-play-state: paused |