animate() 是 jQuery 做自訂動畫的核心,掌握它就等於掌握了 jQuery 特效系統的八成。本文整理它的兩種簽名、參數規則,以及搭配 stop() 的實務技巧。
用於建立自訂動畫。關鍵在於傳入一個「屬性 → 目標值」的物件,物件中的每個屬性都代表一個可變化的樣式屬性,例如 height、top、opacity。
幾條重要規則:
1. 屬性名稱必須使用駝峰式,例如要寫 marginLeft 而不是 margin-left。
2. 屬性值代表動畫的終點。若為數值,就從目前值漸變到目標值;若為 hide、show、toggle 等字串,則呼叫該屬性的預設動畫。
3. 從 jQuery 1.2 起支援 em 與 % 單位,並可在值前面加 += 或 -= 做相對運動。
4. jQuery 1.3 起,若 duration 設為 0 會直接完成動畫;舊版本則會改跑預設時長。
一次動畫多個屬性的例子:
$("#go").click(function () {
$("#block").animate({
width: "90%",
height: "100%",
fontSize: "10em",
borderWidth: 10
}, 1000);
});
第二種簽名以 options 物件取代逐個參數,控制力更細。第一顆按鈕示範了「不排隊」的動畫:div 擴展到 90% 的同時也在放大字體,而邊框動畫要等字體結束後才開始。
$("#go1").click(function () {
$("#block1").animate({ width: "90%" }, { queue: false, duration: 5000 })
.animate({ fontSize: '10em' }, 1000)
.animate({ borderWidth: 5 }, 1000);
});
$("#go2").click(function () {
$("#block2").animate({ width: "90%" }, 1000) // 預設 queue: true
.animate({ fontSize: '10em' }, 1000)
.animate({ borderWidth: 5 }, 1000);
});
兩者的差別就在 queue:設為 false 時動畫並行播放,預設的 true 則會依序排隊。options 還可接受 easing(需搭配 jQuery Easing 外掛才有更多曲線)、complete(每個元素結束後的回呼)、step(每個屬性每步的回呼)與 specialEasing。
用來中止指定元素上正在執行的動畫。若佇列中還有等待中的動畫,且未將 clearQueue 設為 true,它們會立即接著執行。
clearQueue(Boolean):設為 true 時清空佇列,動畫立刻結束。
gotoEnd(Boolean):讓目前的動畫直接跳到終點,並重設 show/hide 的原始樣式、呼叫回呼函式。
// 開始動畫
$("#go").click(function () {
$(".block").animate({ left: '+200px' }, 5000);
});
// 點擊後停在當前位置
$("#stop").click(function () {
$(".block").stop();
});
// 直接跳到終點並清空後續動畫
$("#stopEnd").click(function () {
$(".block").stop(true, true);
});
滑鼠移入移出時,若每次都觸發一組動畫,快速游移會造成畫面抖動。此時應在動畫前先呼叫 .stop(true) 清掉舊動畫。另外,jQuery 3.x 已移除 $.browser 等舊 API,效果類的方法(如 .animate())在 3.x 仍可用,但官方已把 Tween 機制標記為維護模式;新專案若追求效能,建議評估 CSS transition 搭配 class 切換的做法,它能交給瀏覽器的合成器處理,通常比 JS 逐幀運算更順。