萬盛學電腦網

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

jQuery fadeIn() 方法詳解:從隱藏到顯示的淡入動畫實戰指南

方法定位

.fadeIn() 將元素從 display: none 狀態,通過 漸變 opacity 從 0 到 1 實現「淡入顯示」效果。需配合初始隱藏(display:none、visibility:hidden 或 .hide())使用。

語法速查

.fadeIn([duration] [, easing] [, complete])
// 參數同 fadeOut()

完整範例:三種速度淡入對比

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>fadeIn 速度對比</title>
  <style>
    .box { width: 80px; height: 80px; margin: 10px; float: left; display: none; }
    #div1 { background: #e74c3c; }  /* 紅 - 默認 400ms */
    #div2 { background: #f39c12; }  /* 橙 - slow 600ms */
    #div3 { background: #3498db; }  /* 藍 - 3000ms */
  </style>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
  <p>點擊按鈕觀察三個色塊以不同速度淡入</p>
  <button id="btn-fadein">淡入顯示色塊</button>
  <br><br>
  <div id="div1" class="box"></div>
  <div id="div2" class="box"></div>
  <div id="div3" class="box"></div>

  <script>
    $('#btn-fadein').click(function() {
      $('#div1').fadeIn();        // 400ms
      $('#div2').fadeIn('slow');  // 600ms
      $('#div3').fadeIn(3000);    // 3000ms
    });
  </script>
</body>
</html>

內部原理:從隱藏到顯示的完整流程

  1. 檢查元素是否可見(offsetWidth/Height > 0 且非 display:none),可見則直接返回。
  2. 2. 記錄元素原始 display 值(若為 none 則默認 block)。 3. 設置 opacity: 0、display: 原始display值、visibility: visible。 4. 動畫 opacity: 0 → 1。 5. 完成時移除內聯 opacity,恢復原始 CSS 狀態。

進階實戰模式

1. 回調鏈:淡入後聚焦輸入框


$('#modal').fadeIn(300, function() {
  $(this).find('input:first').trigger('focus');
});

2. Promise 化等待淡入完成


async function showModal() {
  await $('#modal').fadeIn(300).promise();
  startTour(); // 確保模態框完全可見後啟動引導
}

3. 條件淡入:僅隱藏時執行


function showTooltip($tip) {
  if ($tip.is(':hidden')) $tip.fadeIn('fast');
  // 已顯示則不重複動畫
}

4. 批量錯開淡入(交錯動畫)


$('.card:hidden').each(function(i) {
  $(this).delay(i * 100).fadeIn(300); // 依次延遲 100ms 淡入
});

fadeIn vs CSS Transition 現代對比


/* CSS 方案:性能更優、無 JS 阻塞 */
.tooltip {
  opacity: 0;
  visibility: hidden;
  transition: opacity 0.2s ease, visibility 0.2s ease;
}
.tooltip.show {
  opacity: 1;
  visibility: visible;
}

/* JS 只切類名 */
$('#tooltip').addClass('show');
// 隱藏時
$('#tooltip').removeClass('show');

選型建議:同 fadeOut,簡單場景用 CSS,複雜邏輯用 jQuery。

常見坑點避雷

  • 元素已可見時調用無效果:.fadeIn() 會檢測可見性直接返回。需先 .hide() 或 .css('display','none')。
  • inline 元素淡入佈局跳動:display:block 會改變佈局流。解決:CSS 預設 display:inline-block 或動畫容器用 position:absolute。
  • 動畫期間內容閃爍:因 visibility:hidden → visible 切換。確保初始 CSS 含 visibility:hidden。
  • 表單自動填充導致淡入失效:瀏覽器自動填充會設置 display:block。對策:autocomplete="off" 或動畫前強制 .hide()。

實際業務場景

  1. 下拉選單/彈出層展開:$dropdown.fadeIn(150)。
  2. 圖片懶加載成功後淡入:img.onload = () => $(img).fadeIn(300)。
  3. 分步表單步驟切換:$step.hide().eq(index).fadeIn()。
  4. 載入骨架屏 → 真實內容淡入:$skeleton.fadeOut(200, () => $content.fadeIn(300))。

總結

.fadeIn() 是 jQuery 中「從無到有」淡入的標準方法,自動處理隱藏狀態檢測、display 恢復、opacity 動畫。現代項目中優先 CSS Transition/Animation,但在動態條件判斷、精確回調控制、錯開動畫編排、舊瀏覽器兼容等場景,.fadeIn() 依然提供極佳的開發體驗與穩定性。掌握其內部流程與邊界條件,能避免「為什麼不動畫」、「為什麼佈局亂了」等經典疑難雜症。

copyright © 萬盛學電腦網 all rights reserved