萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 元素顯示/隱藏完整指南:hide/show/toggle/fade/slide 動畫詳解

基礎顯示/隱藏

// 立即隱藏/顯示 (無動畫)
$("#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

現代最佳實踐建議

  1. 優先用 CSS Transition/Animation:效能佳 (GPU 加速)、可維護、無 JS 阻塞
  2. 簡單切換用 classList.toggle():el.classList.toggle('hidden')
  3. 複雜序列動畫用 Web Animations API:el.animate(keyframes, options)
  4. 需 JS 協調時:requestAnimationFrame 或 GSAP 等專業動畫庫
  5. 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
copyright © 萬盛學電腦網 all rights reserved