萬盛學電腦網

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

jQuery slideDown() 方法詳解:實現模塊滑動展開的流暢體驗

方法定位

.slideDown() 將元素從 display: none 狀態,通過 漸增高度至原始高度 實現「向下滑動展開」效果。需配合初始隱藏(display:none 或 .hide())使用。

語法速查

.slideDown([duration] [, easing] [, complete])
// 參數同 slideUp()

完整範例:點擊展開面板

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>slideDown 示例</title>
  <style>
    #flip, #panel {
      padding: 15px; text-align: center;
      background: #e5eecc; border: 1px solid #c3c3c3;
      cursor: pointer;
    }
    #panel {
      padding: 50px; display: none; /* 關鍵:初始隱藏 */
      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').slideDown('slow', function() {
        console.log('展開完成');
      });
    });
  </script>
</body>
</html>

核心機制:高度計算與恢復

  1. 若元素當前 display:none,jQuery 臨時設置 display:block、visibility:hidden、position:absolute 測量真實高度。
  2. 恢復原樣式,設置 overflow:hidden、height:0 起始。
  3. 動畫到測量高度,結束時移除 overflow、height 內聯樣式,還原 CSS 定義的高度/內距/邊框。

進階實戰技巧

1. 動態內容載入後展開

$('#load-btn').click(function() {
  var $panel = $('#panel').html('載入中...').slideDown(300);
  $.get('/api/content').done(function(html) {
    $panel.html(html); // 內容替換,高度自動適應(因結束時移除 height)
  });
});

2. 手風琴:單一展開

$('.accordion-title').click(function() {
  var $content = $(this).next('.accordion-content');
  $('.accordion-content').not($content).slideUp(200);
  $content.slideDown(300);
});

3. 防抖:避免重複觸發

$('#flip').click(function() {
  var $panel = $('#panel');
  if ($panel.is(':animated')) return; // 正在動畫時忽略
  $panel.slideToggle('fast'); // 自動判斷展開/收起
});

4. 無障礙增強

$('#flip').attr({
  'role': 'button',
  'aria-expanded': 'false',
  'aria-controls': 'panel'
}).click(function() {
  var expanded = $(this).attr('aria-expanded') === 'true';
  $(this).attr('aria-expanded', !expanded);
  $('#panel').slideToggle(300);
});

slideDown vs CSS max-height 技巧對比

維度jQuery slideDownCSS max-height
高度計算 自動精確測量 需預估最大值(過大動畫慢、過小截斷)
性能 觸發重排,主線程執行 可觸發 GPU 加速(transform/opacity)
動態內容 原生適應 需 JS 重算 max-height 或用 grid/auto
控制力 回調、隊列、停止、Promise 僅類名切換,難以精確控制
適用場景 複雜邏輯、未知高度、需精確同步 簡單收展、已知高度範圍、追求性能

常見坑點

  • 忘記初始 display:none:元素可見時調用 slideDown() 無效果。
  • 固定高度容器:父元素 height:200px; overflow:hidden 會截斷動畫,改用 max-height 或移除固定高。
  • 表格行 <tr> 不支持:display:none 破壞表格佈局。用 visibility:collapse 或包裹在 <tbody> 切換。
  • 浮動元素高度塌陷:父容器未清除浮動導致測量高度為 0,加 overflow:hidden 或 clearfix。

總結

.slideDown() 是「展開」交互的首選方法,自動處理高度測量與恢復,配合 .slideUp()/.slideToggle() 覆蓋絕大多數收展場景。現代項目中,簡單場景優先 CSS max-height 過渡,複雜邏輯、動態內容、無障礙需求用 jQuery,兩者互補,構建極致用戶體驗。

copyright © 萬盛學電腦網 all rights reserved