萬盛學電腦網

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

jQuery fadeIn/fadeOut/fadeTo 淡入淡出動畫完整示例

核心方法速查

方法語法說明
fadeIn.fadeIn(duration, easing, complete)從隱藏狀態淡入顯示(display: none → block + opacity 0→1)
fadeOut.fadeOut(duration, easing, complete)淡出隱藏(opacity 1→0 → display: none)
fadeTo.fadeTo(duration, opacity, easing, complete)淡入/出到指定透明度(0-1),**不改變 display**
fadeToggle.fadeToggle(duration, easing, complete)切換顯示/隱藏狀態

完整可運行示例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>jQuery Fade 效果演示</title>
  <style>
    .img-box { width: 300px; height: 300px; border: 1px solid red; display: inline-block; }
    .img-box img { width: 100%; height: 100%; object-fit: cover; }
    button { margin: 5px; padding: 8px 16px; cursor: pointer; }
  </style>
  <script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script>
</head>
<body>
  <div>
    <button id="btnFadeOut">淡出</button>
    <button id="btnFadeIn">淡入</button>
    <button id="btnFadeTo">半透明 (0.3)</button>
    <button id="btnToggle">切換</button>
  </div>
  <div class="img-box">
    <img src="https://picsum.photos/300/300" alt="demo">
  </div>

  <script>
  $(function() {
    var $img = $('.img-box img');

    $('#btnFadeOut').click(function() {
      $img.fadeOut(2000, function() { $(this).prev().text('已淡出'); }); // 回調
    });

    $('#btnFadeIn').click(function() {
      $img.fadeIn(2000, function() { $(this).prev().text('已淡入'); });
    });

    $('#btnFadeTo').click(function() {
      $img.fadeTo(2000, 0.3, function() { alert('動畫執行完畢,透明度 0.3'); });
    });

    $('#btnToggle').click(function() {
      $img.fadeToggle(1000);
    });
  });
  </script>
</body>
</html>

關鍵參數詳解

  • duration:毫秒數,或 'fast' (200)、'slow' (600)。
  • easing:'swing'(默認,緩動)、'linear'(勻速)。需 jQuery UI/easing 插件支援更多曲線。
  • complete:動畫完成後的回調函數,this 指向當前 DOM 元素。
  • 隊列:同一元素多次調用會進入 fx 隊列依次執行。用 .stop(true, true) 清空隊列並跳至終態。

常見問題與解決

  1. 元素有 display: none 但佔據空間:fadeIn 會先設置 display: block(或原來的 display 值),若需 inline-block 需在 CSS 預設或用 .css('display', 'inline-block') 後再 fadeIn。
  2. fadeTo 不改變 display:透明度 0 時元素仍佔據佈局空間,適合「淡隱但保留佈局」。
  3. 動畫卡頓:避免在大量元素上同時動畫,使用 requestAnimationFrame 或 CSS transition/animation 替代(GPU 加速)。
  4. 移動端性能:優先用 CSS opacity + transition,JS 動畫僅作邏輯控制觸發 class 切換。

現代替代:CSS Transition

.fade-enter { opacity: 0; transition: opacity 0.3s ease; }
.fade-enter-active { opacity: 1; }
.fade-leave { opacity: 1; transition: opacity 0.3s ease; }
.fade-leave-active { opacity: 0; pointer-events: none; }

配合 Vue <Transition>、React CSSTransition 等組件使用,性能更優、無 JS 依賴。

copyright © 萬盛學電腦網 all rights reserved