delay() 是 jQuery 1.4 才加入的方法,簽名為 .delay(duration [, queueName]),作用是在效果佇列中插入一段等待時間,讓排在它後面的動畫晚一點才開始。
duration:延遲的毫秒數。
queueName:佇列名稱,預設是 fx,也就是動畫佇列。若要對自訂佇列生效,需自行指定名稱。
讓頁首與頁尾先停在畫面外,一秒後再滑回來,比同時出現更有層次:
$(document).ready(function () {
$('#header')
.css({ 'top': -50 })
.delay(1000)
.animate({ 'top': 0 }, 800);
$('#footer')
.css({ 'bottom': -15 })
.delay(1000)
.animate({ 'bottom': 0 }, 800);
});
delay 只對佇列中的動畫有效。它不會延遲 fadeIn 之外的立即操作,例如 .css()、.addClass()、.show() 這類同步方法會照原時機執行。若想让淡入淡出也排隊,它們本身就屬於 fx 佇列,所以沒問題;但 .hide() 混進來時就要留意。
它不能取代 setTimeout。delay 只能作用在 jQuery 效果鏈上,若要延遲執行任意 JavaScript 邏輯(例如發請求、改變數),仍應用 setTimeout。
搭配 stop() 時要小心。.stop(true) 會把包含 delay 在內的整個佇列清空,因此滑鼠快速進出時,用 stop(true, true) 或直接改寫成 hover 的 fadeIn/fadeOut 組合,往往比依賴 delay 更可控。
若要把 delay 用在自訂佇列上,得明確指定名稱,並記得手動 dequeue:
$('div').queue('myQueue', function () { /* 做事 */ });
$('div').delay(500, 'myQueue').dequeue('myQueue');
總的來說,delay 是個語意清楚的小工具:當你想在動畫序列裡「停一拍」,它比拆成兩段 setTimeout 再串接要乾淨得多。