slideUp() 會以「高度逐格遞減」的動畫把元素收合起來,最後設為 display:none。它是手風琴、展開式面板這類元件最基本的建材,與 slideDown()、slideToggle() 合稱滑動三兄弟。
<!DOCTYPE html>
<html>
<head>
<script src="js/jquery.min.js"></script>
<script>
$(document).ready(function(){
$("#flip").click(function(){
$("#panel").slideUp("slow");
});
});
</script>
<style type="text/css">
#panel, #flip {
padding:5px;
text-align:center;
background-color:#e5eecc;
border:solid 1px #c3c3c3;
}
#panel { padding:50px; }
</style>
</head>
<body>
<div id="flip">Click to slide up panel</div>
<div id="panel">Hello world!</div>
</body>
</html>
$("#panel").slideUp(400); // 400 毫秒
$("#panel").slideUp("slow"); // 600 毫秒
$("#panel").slideUp("normal"); // 400 毫秒
$("#panel").slideUp("fast"); // 200 毫秒
動畫結束後才能確定元素真的不可見,因此任何依賴「已收合」狀態的程式都該寫在回呼裡:
$("#panel").slideUp("slow", function(){
console.log("面板已收起");
$("#status").text("已收合");
});
讓多個面板同時只展開一個,只要在 callback 裡把其他面板收合:
$(".accordion-header").click(function(){
var $next = $(this).next(".accordion-body");
$(".accordion-body").not($next).slideUp(300);
$next.slideToggle(300);
});
padding 會被吃掉:slideUp 動畫的過程是壓縮高度,若元素有大的 padding,動畫結束後 padding 也一併消失(因為 display 變 none)。這通常是期望行為,但若你要在收合後保留空間,應該改用控制 class 的方式。
動畫會堆疊:快速連續點擊會讓收合/展開排隊播放,看起來像卡住。加上 .stop(true, true) 可清空佇列並立刻跳到最終狀態。
不能被動畫的元素:display:none 的元素的 slideUp() 不會有任何效果,而 table 的 <tr>、<tbody> 在部分舊瀏覽器上做高度動畫也會異常,實務上建議在裡面包一層 div。
若追求更細緻的控制(例如自訂 easing 或避免 JS 阻塞),改用 CSS 操作 max-height 加 transition 也是常見做法。