萬盛學電腦網

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

jQuery slideUp() 方法詳解:實現元素滑動收起的優雅交互

方法定位

.slideUp() 通過 漸變高度至 0 並最終設置 display: none,實現元素「向上滑動收起」的視覺效果。屬於 jQuery 內建滑動動畫三件套之一(配合 .slideDown()、.slideToggle())。

語法速查

.slideUp([duration] [, easing] [, complete])
// duration: 'fast'(200) | 'slow'(600) | 毫秒數 | 預設 400
// easing: 'swing' (默認) | 'linear' | 自定義
// complete: 動畫結束回調

完整可運行範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>slideUp 示例</title>
  <style>
    #panel, #flip {
      padding: 15px; text-align: center;
      background: #e5eecc; border: 1px solid #c3c3c3;
      cursor: pointer; user-select: none;
    }
    #panel { padding: 50px; background: #f0f8ff; border-top: none; }
  </style>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
  <div id="flip">點擊我:滑動收起下方面板</div>
  <div id="panel">Hello World! 這是面板內容區域。</div>

  <script>
    $('#flip').click(function() {
      $('#panel').slideUp('slow', function() {
        console.log('收起完成,display 已變為 none');
      });
    });
  </script>
</body>
</html>

內部原理

  1. 記錄元素當前 height、paddingTop、paddingBottom、borderTop、borderBottom。
  2. 設置 overflow: hidden 避免內容外溢。
  3. 動畫過程中同步縮減上述 CSS 屬性至 0。
  4. 動畫結束時設置 display: none 並恢復原始樣式值(供下次 slideDown 使用)。

進階用法與技巧

1. 回調函數鏈式處理

$('#panel').slideUp(400, function() {
  $(this).remove(); // 動畫結束後徹底移除 DOM
});

2. 搭配 slideDown 實現手風琴

$('.accordion-header').click(function() {
  var $panel = $(this).next('.accordion-panel');
  $panel.slideToggle(300);
  $('.accordion-panel').not($panel).slideUp(300); // 關閉其他
});

3. 防止動畫隊列堆疊

// 點擊狂按不會疊加動畫
$('#flip').click(function() {
  $('#panel').stop(true, true).slideUp('slow');
});

4. 響應式:行動裝置改用 fadeOut

var isMobile = /Mobi|Android/i.test(navigator.userAgent);
$('#panel')[isMobile ? 'fadeOut' : 'slideUp']('fast');

常見問題與解決

現象原因解決
動畫卡頓、跳躍 元素有 margin 塌陷、浮動未清除 父容器 overflow: hidden 或 clearfix;改用 padding 替代 margin
內容被截斷 動畫中 overflow:hidden 切掉超出高度部分 確保動畫前高度足夠,或用 max-height 過渡替代
slideUp 後佔位消失 最終 display:none 導致文檔流重排 預期行為;若需保留佔位用 .animate({height:0,opacity:0}) 不隱藏
表單元素無法滑動 <select>、<iframe> 等替換元素渲染層級較高 動畫前 .css('visibility','hidden') 或改用 fade

slideUp vs CSS Transition 對比

/* CSS 版:性能更好、可硬體加速、無 JS 依賴 */
.panel {
  max-height: 500px; /* 需估算最大高度 */
  overflow: hidden;
  transition: max-height 0.4s ease, opacity 0.3s ease;
}
.panel.collapsed {
  max-height: 0;
  opacity: 0;
  pointer-events: none;
}

/* JS 觸發 */
$('#panel').toggleClass('collapsed');

建議:簡單收展用 CSS;複雜邏輯(回調、條件、隊列)用 jQuery。

總結

.slideUp() 是實現「收起」交互的標準方法,語義清晰、API 簡潔。掌握其高度動畫原理、隊列控制、與 CSS 過渡的取捨,能讓你在手風琴、下拉選單、通知欄、側邊欄收合等高頻場景中寫出流暢、健壯的交互代碼。

copyright © 萬盛學電腦網 all rights reserved