.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>
height、paddingTop、paddingBottom、borderTop、borderBottom。overflow: hidden 避免內容外溢。display: none 並恢復原始樣式值(供下次 slideDown 使用)。$('#panel').slideUp(400, function() {
$(this).remove(); // 動畫結束後徹底移除 DOM
});
$('.accordion-header').click(function() {
var $panel = $(this).next('.accordion-panel');
$panel.slideToggle(300);
$('.accordion-panel').not($panel).slideUp(300); // 關閉其他
});
// 點擊狂按不會疊加動畫
$('#flip').click(function() {
$('#panel').stop(true, true).slideUp('slow');
});
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 |
/* 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 過渡的取捨,能讓你在手風琴、下拉選單、通知欄、側邊欄收合等高頻場景中寫出流暢、健壯的交互代碼。