jQuery 把常見的視覺效果都包好了,大多數只要傳一個速度參數就能用。以下依「淡入淡出 → 滑動 → 自訂動畫 → 動畫控制 → 方法鏈接」整理,並標出每個方法的可選參數。
$(selector).fadeIn(speed, callback);
$("button").click(function(){
$("#div1").fadeIn();
$("#div2").fadeIn("slow");
$("#div3").fadeIn(3000);
});
$(selector).fadeOut(speed, callback);
元素目前是隱藏的就淡入,是顯示的就淡出。
$(selector).fadeToggle(speed, callback);
$("button").click(function(){
$("#div1").fadeToggle();
$("#div2").fadeToggle("slow");
$("#div3").fadeToggle(3000);
});
$(selector).fadeTo(speed, opacity, callback);
$("button").click(function(){
$("#div1").fadeTo("slow", 0.15);
$("#div2").fadeTo("slow", 0.4);
$("#div3").fadeTo("slow", 0.7);
});
speed 可取 "slow"、"fast" 或毫秒數;opacity 是 0 到 1 之間的數字。與前三者不同的是,fadeTo() 不會改變元素的顯示/隱藏狀態,只調整透明度,所以它適合做「滑過時變淡」這種效果。
$(selector).slideDown(speed, callback);
$("#flip").click(function(){
$("#panel").slideDown();
});
$(selector).slideUp(speed, callback);
$(selector).slideToggle(speed, callback);
三個滑動方法的 speed 與 callback 意義相同:速度可取 slow/fast/毫秒,callback 是動畫結束後要執行的函式名稱。
$(selector).animate({params}, speed, callback);
params 定義要做成動畫的 CSS 屬性;speed 與 callback 同上。
$("button").click(function(){
$("div").animate({ left: '250px' });
});
也可以使用相對值,在數值前加上 += 或 -=:
$("div").animate({ width: '+=50px' });
傳入多組屬性物件能形成佇列效果,依序播放:
$("div").animate({ left: '250px' })
.animate({ top: '100px' });
要注意的是,animate() 只能動 數值型的 CSS 屬性(寬高、位置、透明度、邊距等)。color、background-color 這類顏色屬性需要額外引入 jQuery UI 或 color 插件才能動。另外,涉及版面重排的屬性(width、height、top、left)效能較差,大量使用時應考慮改用 transform 搭配 CSS transition。
stop():在動畫完成前中止它。這在滑入滑出的選單上特別重要,否則連續快速滑動會讓動畫堆成一長串。
$("button").click(function(){
$("#panel").stop(true, true).slideToggle();
});
// stop(clearQueue, jumpToEnd):清空佇列並直接跳到最終狀態
callback:動畫 100% 完成後才呼叫,典型語法如下:
$(selector).hide(speed, callback);
有些元素只查詢一次就好,後續動作可以串成一條:
$("#p1").css("color", "red").slideUp(2000).slideDown(2000);
鏈式寫法不只是好看——jQuery 內部會自動快取每一步的結果,因此通常比反覆查詢再操作來得快。一個實務上的小建議:鏈太長時適度斷行,可讀性會好很多。
除錯或製作低動態版本時,可以一次關掉所有效果:
jQuery.fx.off = true; // 所有動畫直接跳到終點
另外,為尊重系統的「減少動態效果」偏好,建議在正式環境中偵測並降級:
var reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
$("div").animate({ left: '250px' }, reduceMotion ? 0 : 500);