萬盛學電腦網

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

jQuery 滑動效果大全:slideDown、slideUp、slideToggle 參數與進階控制

jQuery 內建三大滑動方法,透過高度動畫實現展開/收合效果。掌握速度控制、回調、佇列、停止動畫、CSS 配合,能構建流暢的手風琴、下拉選單、通知欄。

三大核心方法

方法行為典型用途
.slideDown(speed, easing, callback)高度從 0 → 實際高度 (顯示)下拉選單、展開詳情、通知顯示
.slideUp(speed, easing, callback)高度從實際 → 0 (隱藏)收合面板、關閉通知、表單驗證錯誤收合
.slideToggle(speed, easing, callback)切換顯示/隱藏手風琴標題點擊、側邊欄切換

參數詳解

  • speed:`'slow'` (600ms)、`'fast'` (200ms)、數字毫秒數。預設 400ms。
  • easing:`'swing'` (預設、緩入緩出)、`'linear'` (勻速)。需 jQuery UI 或 `jquery.easing` 擴展更多曲線。
  • callback:動畫完成後執行,`this` 指向原生 DOM 元素。
// 基本用法
$('#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);
});

進階控制

1. 停止動畫佇列

// 立即停止當前動畫,跳至終態
$('#panel').stop(true, true).slideToggle();

// 僅停止動畫,保留佇列
$('#panel').stop(false, false);

2. 判斷可見狀態

if ($('#panel').is(':visible')) { /* 已展開 */ }
if ($('#panel').is(':animated')) { /* 正在動畫中 */ }

3. CSS 配合:`display` vs `visibility`

  • slide 方法操作 `height` + `overflow:hidden` + `display`。
  • 元素初始必須 `display: none` 或透過 `.hide()` 隱藏,`slideDown` 才會正確計算高度。
  • 若元素 `visibility: hidden` 或 `opacity: 0` 但 `display: block`,slide 無效果。

4. 自動高度問題 (內容動態變化)

// slideDown 後內容變動 (如 AJAX 載入),高度不會自動調整
// 解法:動畫完成後重新計算
$content.slideDown(300, function() {
  this.style.height = 'auto'; // 恢復自動高度
  // 或重新觸發 slideDown(0) 刷新
});

原生 CSS 替代方案(現代首選)

.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。

無障礙增強

  • 加上 `aria-expanded="true/false"`、`aria-controls="panel-id"`。
  • 鍵盤 `Enter`/`Space` 觸發切換。
  • 尊重 `prefers-reduced-motion: reduce` 關閉動畫。

滑動效果是 UI 互動基石,理解動畫佇列、高度計算、CSS 替代方案,能根據專案複雜度選擇最適工具。

copyright © 萬盛學電腦網 all rights reserved