animate() 是 jQuery 裡最常用的動畫方法,能對任何數值型 CSS 屬性做補間動畫。它最大的優點是語法直覺,而且動畫效果可以排隊依序執行。
這個範例做一個常見的側邊資訊欄:點標題時內容平滑收合或展開,同時標題上的箭頭圖示也跟著切換。
<script type="text/javascript">
$(document).ready(function(){
$(".side-box h3").toggle(function(){
$(this).addClass("box-arrow");
$(this).next(".side-text").animate({ height: 'toggle', opacity: 'toggle' }, "slow");
return false;
}, function(){
$(this).next(".side-text").animate({ height: 'toggle', opacity: 'toggle' }, "slow");
$(this).removeClass("box-arrow");
return false;
});
});
</script>
toggle(fn1, fn2) 是舊版 jQuery 的寫法,第一次點擊執行第一個函式,第二次執行第二個,之後輪流。兩個函式做的事幾乎對稱:切換箭頭的 class,並讓下一個兄弟元素的高度與透明度做 toggle 動畫。
height: 'toggle' 是關鍵——toggle 會依元素目前狀態自動決定要放大還是縮小,因此同一段程式碼能同時處理展開與收合兩種情況,不必額外判斷。
動畫速度字串 "slow" 對應 600 毫秒,"fast" 是 200 毫秒,也可以直接傳入數字自訂。
第一,它能動的只有數值型屬性,color 這類需要 jQuery UI 或 color 外掛支援;直接寫 background-color: 'red' 是無效的。
第二,animate(props, duration, easing, complete) 的第四個參數是完成後的回呼函式,多段動畫要依序發生時,就把下一步寫在這個回呼裡(本文另一篇晃動效果就是這樣做的)。
第三,toggle() 這種多參數用法在 jQuery 1.9 之後已被移除,若使用新版請改寫為監聽 click 並自行用一個旗標變數記錄狀態,或直接改用 slideToggle() 達成相同效果。