萬盛學電腦網

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

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

核心方法速查

方法效果參數回調
show()顯示(display: block/inline 等)duration, easing, callback動畫完成後
hide()隱藏(display: none)duration, easing, callback動畫完成後
toggle()切換顯示/隱藏duration, easing, callback動畫完成後
fadeIn()淡入(opacity 0→1)duration, easing, callback動畫完成後
fadeOut()淡出(opacity 1→0)duration, easing, callback動畫完成後
fadeToggle()淡入/淡出切換duration, easing, callback動畫完成後
slideDown()向下滑動展開(height 0→auto)duration, easing, callback動畫完成後
slideUp()向上滑動收合(height auto→0)duration, easing, callback動畫完成後
slideToggle()滑動展開/收合切換duration, easing, callback動畫完成後

參數詳解

  • duration:'fast'(200ms)、'normal'(400ms)、'slow'(600ms) 或毫秒數
  • easing:'swing'(預設,緩動)、'linear'(勻速);更多需引入 jQuery UI/easing 插件
  • callback:function() { ... },動畫完成後執行,this 指向當前元素

基礎範例:按鈕控制顯示/隱藏

<style>
  #panel { display:none; padding:20px; background:#f0f8ff; border:1px solid #007bff; margin-top:10px; }
  button { margin-right:8px; padding:6px 12px; cursor:pointer; }
</style>

<button id="btnShow">顯示</button>
<button id="btnHide">隱藏</button>
<button id="btnToggle">切換</button>
<button id="btnFadeIn">淡入</button>
<button id="btnFadeOut">淡出</button>
<button id="btnSlide">滑動切換</button>

<div id="panel">
  <h3>動態內容面板</h3>
  <p>這裡可以放置任何 HTML 內容,包括表單、表格、圖片等。</p>
</div>

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script>
$(function () {
  var $panel = $('#panel');

  $('#btnShow').click(function () { $panel.show(300); });
  $('#btnHide').click(function () { $panel.hide(300); });
  $('#btnToggle').click(function () { $panel.toggle(300); });

  $('#btnFadeIn').click(function () { $panel.fadeIn(400); });
  $('#btnFadeOut').click(function () { $panel.fadeOut(400); });

  $('#btnSlide').click(function () { $panel.slideToggle(400); });
});
</script>

進階用法

1. 回調函式鏈式動畫

$('#box')
  .fadeOut(300)
  .delay(200) // 暫停 200ms
  .fadeIn(300, function () {
    console.log('動畫序列完成');
  });

2. 動畫佇列控制

// 停止當前動畫並清空佇列,立即執行新動畫
$('#box').stop(true, true).fadeIn(200);

// 僅停止當前動畫,保留佇列
$('#box').stop(false, false);

3. 自定義動畫 .animate()

$('#box').animate({
  opacity: 0.5,
  width: '300px',
  height: '200px',
  marginLeft: '50px'
}, {
  duration: 800,
  easing: 'swing',
  complete: function () { console.log('自定義動畫結束'); },
  step: function (now, fx) { /* 每幀回調,可做複雜同步 */ }
});

4. CSS 類切換配合動畫(現代推薦)

<style>
  .panel { transition: opacity .3s ease, transform .3s ease; opacity:1; transform:translateY(0); }
  .panel.hidden { opacity:0; transform:translateY(-20px); pointer-events:none; }
</style>

<script>
$('#btnToggle').click(function () {
  $('#panel').toggleClass('hidden'); // 由 CSS 控制動畫,效能更好、可硬體加速
});
</script>

原生 JavaScript 替代方案(無依賴)

現代專案建議優先 CSS Transition/Animation + Class 切換,或使用 Anime.js、GSAP 等輕量動畫庫。若需極簡替代:

// 簡易 fadeIn/fadeOut
function fadeIn(el, duration) {
  el.style.opacity = 0;
  el.style.display = '';
  var start = performance.now();
  function tick(now) {
    var p = Math.min((now - start) / duration, 1);
    el.style.opacity = p;
    if (p < 1) requestAnimationFrame(tick);
  }
  requestAnimationFrame(tick);
}

function fadeOut(el, duration) {
  var start = performance.now();
  var initial = parseFloat(getComputedStyle(el).opacity) || 1;
  function tick(now) {
    var p = Math.min((now - start) / duration, 1);
    el.style.opacity = initial * (1 - p);
    if (p === 1) el.style.display = 'none';
    else requestAnimationFrame(tick);
  }
  requestAnimationFrame(tick);
}

常見坑點與避坑

  1. display:none 元素無法獲取尺寸:width()/height() 返回 0。解決:先 css({position:'absolute',visibility:'hidden',display:'block'}) 測量,再恢復。
  2. 動畫佇列堆疊:快速連點導致動畫排隊。解決:.stop(true,true) 或加鎖標誌位。
  3. jQuery 3+ show/hide 行為變更:不再強制 display:block,改為恢復原有 display 值(記錄在 data-olddisplay)。
  4. SVG 元素動畫受限:jQuery 對 SVG 的 display 操作有 bug,建議直接操作 style.display 或用 CSS。

結語

jQuery 的顯示/隱藏動畫 API 簡單易用,但現代開發建議「CSS 負責動畫,JS 負責狀態切換」。理解 show/hide/toggle、fade*、slide* 核心差異與佇列機制,能在維護舊專案時快速定位問題;新專案請擁抱 CSS + Class 切換或專業動畫庫。

copyright © 萬盛學電腦網 all rights reserved