jQuery 把 JavaScript 動畫的複雜細節都封裝掉了,只要給定「最終狀態」與「時間」,它就幫你把中間的每一幀補起來。以下把常用的動畫方法逐一整理。
語法:show(speed, callback),speed 為動畫執行時間(毫秒),也可寫成 "slow"、"normal"、"fast";callback 為動畫完成後執行的函式。
進階寫法:show(speed, [easing], callback),easing 預設是 swing,可選 linear。
$("#div1").show(3000, function () { alert("動畫顯示完成!"); });
語法:hide(speed, callback) 或 hide(speed, easing, callback)。
$("#div1").hide(3000, function () { alert("動畫隱藏完成"); });
目前是顯示就隱藏,目前是隱藏就顯示。語法:toggle(speed, callback)。
$("#div1").toggle(3000, function () { alert("動畫效果切換完成"); });
與 show() 的差別在於方向感:show() 是水平與垂直同時展開,slideDown() 只在垂直方向向下展開。語法:slideDown(speed, callback)。
$("#div1").slideDown(3000, function () { alert("向下展開顯示成功!"); });
同理,hide() 是水平與垂直兩方向一起縮,slideUp() 只在垂直方向向上收起。語法:slideUp(speed, callback)。
$("#div1").slideUp(3000, function () { alert("向上收起隱藏成功!"); });
toggle 是水平與垂直都動,slideToggle 只在垂直方向切換。語法:slideToggle(speed, callback)。
$("#div1").slideToggle(3000, function () { alert("垂直方向上切換成功"); });
以改變透明度的方式出現。語法:fadeIn(speed, callback)。
$("#div1").fadeIn(3000, function () { alert("淡入顯示成功!"); });
語法:fadeOut(speed, callback)。
$("#div1").fadeOut(3000, function () { alert("淡出隱藏成功!"); });
語法:fadeToggle(speed, callback)。
$("#div1").fadeToggle(3000, function () { alert("淡入淡出切換成功!"); });
語法:fadeTo(speed, opacity, callback),opacity 為 0 到 1 之間的數值。
$("#div1").fadeTo(3000, 0.22, function () { alert("透明度改變成功!"); });
只要是數值變動的屬性,幾乎都能拿來做動畫。語法:animate(params, speed, easing, callback)。
$("#div1").animate({ width: "300px", height: "300px" }, 3000);
params 要用大括號包起來,可使用的 CSS 屬性如下(注意要採用駝峰命名法,例如 font-size 要寫成 fontSize;顏色漸變不支援):
backgroundPosition, borderWidth, borderBottomWidth, borderLeftWidth, borderRightWidth, borderTopWidth, borderSpacing, margin, marginBottom, marginLeft, marginRight, marginTop, outlineWidth, padding, paddingBottom, paddingLeft, paddingRight, paddingTop, height, width, maxHeight, maxWidth, minHeight, minWidth, font, fontSize, bottom, left, right, top, letterSpacing, wordSpacing, lineHeight, textIndent
語法:stop([clearQueue], [gotoEnd]),兩個參數都是布林值。第一個表示是否清空待執行的動畫佇列,第二個表示若停止,是否直接跳到完成狀態(否則停留在執行到一半的樣子)。
$("#div1").hide(5000); // 此動畫正在執行
$("#div1").stop(); // 停止在中途狀態
$("#div1").stop(true, true);// 停止當前動畫並跳到完成狀態
快速滑過菜單時連續觸發動畫導致畫面「抽搐」,幾乎都是忘了在 animate 前先 stop 造成的。
語法:delay(duration, [queueName])。動畫被 stop 之後,還能用 delay 從停止處延遲續跑。
$("#div1").delay(3000).hide(3000); // 3000 毫秒後執行 hide(3000)
設為 true 之後,所有設定了執行時間的動畫會瞬間完成,沒有過渡效果。這個屬性出現的位置會影響生效範圍:
$(function () {
jQuery.fx.off = true; // 寫在外面,對頁面載入後的所有動畫有效
$("#div1").click(function () {
// 若寫在這裡,只對當前點擊事件生效,不影響其他事件
$("#div1").hide(3000); // 因 fx.off 為 true,3000 毫秒失效,等同 hide()
});
});
這個開關在開發除錯時很好用,也在使用者系統偏好設定為「減少動態效果」時該主動尊重。
單位是毫秒,數值越小動畫越順,但 CPU 佔用也越高(預設 13 毫秒)。同樣地,出現位置決定影響範圍:
$(function () {
jQuery.fx.interval = 1000;
$("#div1").click(function () {
$("#div1").hide(3000); // interval 設為 1000,每秒才更新一次效果
});
});
上述 easing 參數中的 swing 是「先快後慢」的預設 curves,linear 則是等速。若要更多 curves(easeOutBounce、easeInOutQuad 等),需額外引入 jQuery UI 或 jQuery Easing 外掛。
另外,在現代專案中 CSS transition/animation 通常比 jQuery animate 更流暢(交給 GPU 合成、不佔用主執行緒),jQuery 動畫則仍適合需要依其他狀態動態決定數值的情境。