jQuery 的動畫 API 設計得相当克制,就那么幾個方法,卻能組出絕大多數常見效果。把它們的參數規則摸清,之後看任何外掛的原始碼都不會迷路。
最基礎的一對,本質上是在改 display。
$(function () {
$("input:first").click(function () { $("p").hide(); });
$("input:last").click(function () { $("p").show(); });
});
</script>
<input type="button" value="Hide">
<input type="button" value="Show">
<p>點擊按鈕,看看效果</p>
兩個方法都接受相同形式的參數:
show(duration, [callback]); hide(duration, [callback]);
duration 可以是 slow、normal、fast 這類速度字串,也可以是整數毫秒。callback 為可選,在動畫結束後執行。
$("p").hide(300);
$("p").show(500);
toggle() 同樣接受這些參數,切換時會帶上高度收放的過渡。
效果類似褪色,參數規則與 show/hide 完全相同。
fadeIn(duration, [callback]); fadeOut(duration, [callback]);
$("input:eq(0)").click(function () { $("img").fadeOut(3000); });
$("input:eq(1)").click(function () { $("img").fadeIn(1000); });
fadeOut 是「淡到消失」,fadeTo 則是「淡到指定程度」。
fadeTo(duration, opacity, [callback]);
$("img").fadeTo(1000, 0.5); // 半透明
$("img").fadeTo(1000, 0); // 完全消失
參數說明:duration 可選,寫毫秒或 slow/normal/fast;opacity 必填,必須是 0.00 到 1.00 之間的數字;callback 可選,動畫結束後執行——但要注意,若不設 duration 就不能設 callback。
模擬 PPT 裡的拉簾式收放,參數形式與 show/hide 相同。
$("input:eq(0)").click(function () { $("div").add("img").slideUp(1000); });
$("input:eq(1)").click(function () { $("div").add("img").slideDown(1000); });
這裡的 .add("img") 值得學:它把 div 與 img 合併成一個集合,一次對兩者套用動畫,不必分別寫兩次。
考慮到通用性與檔案大小,jQuery 不可能內建所有效果,於是提供了 animate() 讓開發者自己定義。它有兩種形式。
第一種形式(最常用):
animate(params, [duration], [easing], [callback]);
params 是要變化的 CSS 屬性與目標值;duration 同前;easing 控制速度曲線,核心庫只提供 linear 與 swing;callback 在動畫完成後觸發。
$("#block").animate({
opacity: "0.5",
width: "80%",
height: "100px",
borderWidth: "5px",
fontSize: "30px",
marginTop: "40px",
marginLeft: "20px"
}, 2000);
兩條硬性規則:屬性名必須用 Camel 標記法(paddingLeft 而非 padding-left、marginTop 而非 margin-top);屬性值必須是可用數值表達的(width、top、opacity、fontSize 等),像 backgroundColor 這種顏色屬性不在支援範圍內,需要額外載入 Color Animations 插件。
params 中可以用 += 或 -= 表示相對變化,不必事先知道當前值。
$("button:first").click(function () {
$("#block").animate({ left: "-=80px" }, 300); // 向左移
});
$("button:last").click(function () {
$("#block").animate({ left: "+=80px" }, 300); // 向右移
});
前提是先將元素絕對定位(position: absolute),left/top 才有意義。
animate(params, options);
options 是參數物件,可包含 duration、easing、callback、queue 等。其中 queue 是關鍵:它決定多個連續的 animate() 是排隊依序執行(true,預設)還是同時觸發(false)。
// 第一與第二個動畫同時跑,第三個等它們都結束才開始
$("#block1").animate({ width: "90%" },
{ queue: false, duration: 1500 })
.animate({ fontSize: "24px" }, 1000)
.animate({ borderRightWidth: "20px" }, 1000);
// 三個動畫嚴格依序執行
$("#block2").animate({ width: "90%" }, 1500)
.animate({ fontSize: "24px" }, 1000)
.animate({ borderRightWidth: "20px" }, 1000);
把這兩段放在一起對照,queue 的作用就很清楚了:預設情況下 jQuery 會把動畫放進效果佇列(fx queue)裡排隊,而 queue: false 等於說「我不排隊,立刻執行」。想重置效果時,可以用 $("div").css({ width: "", fontSize: "", borderWidth: "" }) 把樣式清空回預設值。
實務上還有兩個 Frequent 需求。一是中斷動畫:連續快速點擊時,動畫會在佇列裡堆積,導致畫面「跑很久才停」。解法是在啟動新動畫前先呼叫 .stop(true, false)——第一個參數清空佇列,第二個參數決定是否跳到最終狀態。
二是動畫屬性的選擇。動畫會觸發重排(reflow),因此能用 transform 就別用 left/top,能用 opacity 就別用 visibility。現代專案中,單純的顯隱與過渡其實交給 CSS transition 會更順,jQuery animate 的價值主要在於「需要依條件動態計算目標值」或「需要 callback 串接多段邏輯」的場合。