.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>
offsetWidth/Height > 0 且非 display:none),可見則直接返回。display 值(若為 none 則默認 block)。
3. 設置 opacity: 0、display: 原始display值、visibility: visible。
4. 動畫 opacity: 0 → 1。
5. 完成時移除內聯 opacity,恢復原始 CSS 狀態。
$('#modal').fadeIn(300, function() {
$(this).find('input:first').trigger('focus');
});
async function showModal() {
await $('#modal').fadeIn(300).promise();
startTour(); // 確保模態框完全可見後啟動引導
}
function showTooltip($tip) {
if ($tip.is(':hidden')) $tip.fadeIn('fast');
// 已顯示則不重複動畫
}
$('.card:hidden').each(function(i) {
$(this).delay(i * 100).fadeIn(300); // 依次延遲 100ms 淡入
});
/* 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')。display:block 會改變佈局流。解決:CSS 預設 display:inline-block 或動畫容器用 position:absolute。visibility:hidden → visible 切換。確保初始 CSS 含 visibility:hidden。display:block。對策:autocomplete="off" 或動畫前強制 .hide()。$dropdown.fadeIn(150)。img.onload = () => $(img).fadeIn(300)。$step.hide().eq(index).fadeIn()。$skeleton.fadeOut(200, () => $content.fadeIn(300))。.fadeIn() 是 jQuery 中「從無到有」淡入的標準方法,自動處理隱藏狀態檢測、display 恢復、opacity 動畫。現代項目中優先 CSS Transition/Animation,但在動態條件判斷、精確回調控制、錯開動畫編排、舊瀏覽器兼容等場景,.fadeIn() 依然提供極佳的開發體驗與穩定性。掌握其內部流程與邊界條件,能避免「為什麼不動畫」、「為什麼佈局亂了」等經典疑難雜症。