.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>
display:none,jQuery 臨時設置 display:block、visibility:hidden、position:absolute 測量真實高度。overflow:hidden、height:0 起始。overflow、height 內聯樣式,還原 CSS 定義的高度/內距/邊框。$('#load-btn').click(function() {
var $panel = $('#panel').html('載入中...').slideDown(300);
$.get('/api/content').done(function(html) {
$panel.html(html); // 內容替換,高度自動適應(因結束時移除 height)
});
});
$('.accordion-title').click(function() {
var $content = $(this).next('.accordion-content');
$('.accordion-content').not($content).slideUp(200);
$content.slideDown(300);
});
$('#flip').click(function() {
var $panel = $('#panel');
if ($panel.is(':animated')) return; // 正在動畫時忽略
$panel.slideToggle('fast'); // 自動判斷展開/收起
});
$('#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);
});
| 維度 | jQuery slideDown | CSS 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> 切換。overflow:hidden 或 clearfix。.slideDown() 是「展開」交互的首選方法,自動處理高度測量與恢復,配合 .slideUp()/.slideToggle() 覆蓋絕大多數收展場景。現代項目中,簡單場景優先 CSS max-height 過渡,複雜邏輯、動態內容、無障礙需求用 jQuery,兩者互補,構建極致用戶體驗。