jQuery 內建三大滑動方法,透過高度動畫實現展開/收合效果。掌握速度控制、回調、佇列、停止動畫、CSS 配合,能構建流暢的手風琴、下拉選單、通知欄。
| 方法 | 行為 | 典型用途 |
|---|---|---|
.slideDown(speed, easing, callback) | 高度從 0 → 實際高度 (顯示) | 下拉選單、展開詳情、通知顯示 |
.slideUp(speed, easing, callback) | 高度從實際 → 0 (隱藏) | 收合面板、關閉通知、表單驗證錯誤收合 |
.slideToggle(speed, easing, callback) | 切換顯示/隱藏 | 手風琴標題點擊、側邊欄切換 |
// 基本用法
$('#panel').slideDown(300, 'swing', () => console.log('展開完成'));
// 手風琴:點擊標題切換內容,關閉其他
$('.accordion-header').on('click', function() {
const $content = $(this).next('.accordion-content');
$('.accordion-content').not($content).slideUp(200);
$content.slideToggle(200);
});
// 立即停止當前動畫,跳至終態
$('#panel').stop(true, true).slideToggle();
// 僅停止動畫,保留佇列
$('#panel').stop(false, false);
if ($('#panel').is(':visible')) { /* 已展開 */ }
if ($('#panel').is(':animated')) { /* 正在動畫中 */ }
// slideDown 後內容變動 (如 AJAX 載入),高度不會自動調整
// 解法:動畫完成後重新計算
$content.slideDown(300, function() {
this.style.height = 'auto'; // 恢復自動高度
// 或重新觸發 slideDown(0) 刷新
});
.panel {
overflow: hidden;
max-height: 0;
transition: max-height 0.3s ease-out;
}
.panel.open {
max-height: 500px; /* 需估算最大高度 */
}
// JS 僅切換類別
$('#trigger').on('click', () => $('.panel').toggleClass('open'));
CSS `max-height` 動畫無需 JS 計算、效能更好、支援硬體加速,但需預估最大高度。複雜互動仍建議 jQuery/GSAP/Web Animations API。
滑動效果是 UI 互動基石,理解動畫佇列、高度計算、CSS 替代方案,能根據專案複雜度選擇最適工具。