animate(params, options) 是 jQuery 用來創建自定義動畫的核心函數,回傳值為 jQuery 物件。
這個函數的關鍵在於指定動畫形式與結果樣式屬性物件。物件中每個屬性都代表一個可變化的樣式屬性(如 height、top、opacity),值代表動畫結束時該屬性要達到多少。如果是數值,屬性會從目前值漸變到指定值;若使用 hide、show 或 toggle 這類字串,則會呼叫該屬性的預設動畫。注意屬性名稱要用駝峰式,例如用 marginLeft 而非 margin-left。在 jQuery 1.2 之後,還能使用 em 與 % 單位,也能透過在值前面加 += 或 -= 做相對運動。
params:包含作為動畫屬性和終值的樣式屬性集合 options:包含動畫選項的集合 duration:預設 "normal",可為 "slow"/"normal"/"fast" 或毫秒數(如 1000) easing:預設 "swing",另可選 "linear"(自訂需外掛) complete:動畫完成時執行的函數 queue:預設 true,設為 false 則不進入動畫隊列
按下第一個按鈕後,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)
.animate({ fontSize: '10em' }, 1000)
.animate({ borderWidth: 5 }, 1000);
});
// 用 slow 切換段落高度與透明度
$("p").animate({ height: 'toggle', opacity: 'toggle' }, { duration: "slow" });
// 500ms 移到 left 為 50 並完全顯示
$("p").animate({ left: 50, opacity: 'show' }, { duration: 500 });
// 使用 easein 緩動(需外掛提供)
$("p").animate({ opacity: 'show' }, { duration: "slow", easing: "easein" });
透過 queue 參數與鏈式寫法的搭配,就能實現從並行到序列的各種動畫節奏。