表單驗證失敗時讓輸入框抖一下,是辨識度很高的錯誤回饋。這個效果很適合寫成可參數化的 jQuery 外掛,讓任何元素都能套用。
jQuery.fn.shake = function (intShakes /* 抖動次數 */,
intDistance /* 抖動幅度(px) */,
intDuration /* 總時長(ms) */) {
this.each(function () {
var jqNode = $(this);
jqNode.css({ position: 'relative' }); // left 需要定位上下文才生效
for (var x = 1; x <= intShakes; x++) {
jqNode.animate({ left: (intDistance * -1) }, ((intDuration / intShakes) / 4))
.animate({ left: intDistance }, ((intDuration / intShakes) / 2))
.animate({ left: 0 }, ((intDuration / intShakes) / 4));
}
});
return this; // 保持鏈式呼叫
};
animate 修改的是 left,而 left 只在元素具備定位上下文時才有效。少了這行,外掛會靜默失效——這是這類腳本最常見的「跑不出效果」原因。
一次抖動分成三段:往左(1/4)、往右(1/2)、回中(1/4)。往右的時間是往左的兩倍,這樣左右位移雖等距,節奏卻不會對稱得死板。總時長除以抖動次數再切分,代表不論抖幾下,整體時間固定,節奏均勻。
外掛回傳 this,才能寫成 $el.shake(...).addClass('error') 這種 jQuery 慣用形式。少了它,外掛就無法接在鏈條中間。
$(function () {
$('#btn').click(function () {
$(this).shake(2, 10, 400); // 抖 2 下、幅度 10px、總長 400ms
});
});
連續點擊會把動畫堆進佇列,抖動看起來會拖尾。在 animate 前加 .stop(true, true) 可清掉未執行的動畫並直接跳到終點。
無條件設成 relative,會改掉元素原本可能是 absolute 或 fixed 的定位。較嚴謹的做法是先檢查,只在 static 時才改:
if (jqNode.css('position') === 'static') jqNode.css('position', 'relative');
抖動本質是短暫的水平位移,用 CSS keyframes 一行就能完成,且由合成器處理、不觸發重排:
@keyframes shake {
0%, 100% { transform: translateX(0); }
25% { transform: translateX(-10px); }
75% { transform: translateX(10px); }
}
.shake { animation: shake .4s ease; }
使用時替換 class 即可觸發:el.classList.remove('shake'); void el.offsetWidth; el.classList.add('shake');(中間那行強制重排,用於重啟動畫)。最後提醒,抖動屬於位移型動畫,對有前庭功能困擾的使用者可能不適,建議包在 prefers-reduced-motion: no-preference 判斷內,並確保錯誤訊息本身有文字說明,不要只靠動畫傳達。