| 方法 | 效果 | 參數 | 回調 |
|---|---|---|---|
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 | 動畫完成後 |
'fast'(200ms)、'normal'(400ms)、'slow'(600ms) 或毫秒數'swing'(預設,緩動)、'linear'(勻速);更多需引入 jQuery UI/easing 插件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>
$('#box')
.fadeOut(300)
.delay(200) // 暫停 200ms
.fadeIn(300, function () {
console.log('動畫序列完成');
});
// 停止當前動畫並清空佇列,立即執行新動畫
$('#box').stop(true, true).fadeIn(200);
// 僅停止當前動畫,保留佇列
$('#box').stop(false, false);
.animate()$('#box').animate({
opacity: 0.5,
width: '300px',
height: '200px',
marginLeft: '50px'
}, {
duration: 800,
easing: 'swing',
complete: function () { console.log('自定義動畫結束'); },
step: function (now, fx) { /* 每幀回調,可做複雜同步 */ }
});
<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>
現代專案建議優先 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);
}
width()/height() 返回 0。解決:先 css({position:'absolute',visibility:'hidden',display:'block'}) 測量,再恢復。.stop(true,true) 或加鎖標誌位。show/hide 行為變更:不再強制 display:block,改為恢復原有 display 值(記錄在 data-olddisplay)。display 操作有 bug,建議直接操作 style.display 或用 CSS。jQuery 的顯示/隱藏動畫 API 簡單易用,但現代開發建議「CSS 負責動畫,JS 負責狀態切換」。理解 show/hide/toggle、fade*、slide* 核心差異與佇列機制,能在維護舊專案時快速定位問題;新專案請擁抱 CSS + Class 切換或專業動畫庫。