原生 JS 實現元素動畫(移動、淡入淡出、彈性等)是前端基礎功,但充滿坑點:定時器重複啟動導致加速、邊界判斷邏輯錯誤、多元素運動互相干擾。本文通過 3 個經典錯誤案例反向講解正確模式,並提供可復用的通用運動框架封裝,幫助開發者建立正確的動畫編程思維。
// ❌ 錯誤:timer 在函數內部,每次調用創建新閉包,無法清除舊定時器
function startMove() {
var timer = null;
var div = document.getElementById("div1");
if (div.offsetLeft === 300) clearInterval(timer); // 永遠清除不了外部的 timer
else {
timer = setInterval(function() {
div.style.left = div.offsetLeft + 10 + "px";
}, 30);
}
}
// ✅ 正確:timer 提升為模塊級/全局變量,統一管理
var timer = null;
function startMove() {
var div = document.getElementById("div1");
clearInterval(timer); // 先清除舊定時器,防止連點加速
timer = setInterval(function() {
if (div.offsetLeft >= 300) { clearInterval(timer); return; }
div.style.left = div.offsetLeft + 10 + "px";
}, 30);
}
核心原則:定時器標識必須在**外部作用域**持久化,每次啟動前先 clearInterval。
// ❌ 錯誤:timer 仍在函數內,雖有 clearInterval 但每次調用生成新 timer 變量
function startMove() {
var timer = null;
clearInterval(timer); // 清除的是當前調用的局部 timer,無效
timer = setInterval(...);
}
同上,必須將 timer 提升至共享作用域(模塊級、類實例屬性、閉包外層變量)。
<style>
#panel { width:150px; height:200px; background:burlywood; position:absolute; left:-150px; top:100px; }
#tab { width:20px; height:60px; background:gold; position:absolute; right:-20px; top:70px; cursor:pointer; }
</style>
<div id="panel"><span id="tab">分享到</span></div>
<script>
var timer = null;
var panel = document.getElementById("panel");
var tab = document.getElementById("tab");
tab.onmouseover = function() { move(0); }; // 展開到 left:0
tab.onmouseout = function() { move(-150); }; // 收縮到 left:-150
function move(target) {
var speed = panel.offsetLeft < target ? 10 : -10;
clearInterval(timer);
timer = setInterval(function() {
if (panel.offsetLeft === target) { clearInterval(timer); return; }
panel.style.left = panel.offsetLeft + speed + "px";
}, 30);
}
</script>
function fadeInOut($imgs, interval) {
var idx = 0, timer;
$imgs.hide().eq(0).show(); // 初始顯示第一張
function next() {
$imgs.eq(idx).fadeOut(500);
idx = (idx + 1) % $imgs.length;
$imgs.eq(idx).fadeIn(500);
}
timer = setInterval(next, interval);
$imgs.parent().hover(
function() { clearInterval(timer); },
function() { timer = setInterval(next, interval); }
);
}
// 使用:fadeInOut($(".banner img"), 3000);
利用 jQuery fadeIn/fadeOut 封裝,自帶懸停暫停。
function animate(el, targetProps, duration, easing, callback) {
var start = {}, startTime = Date.now();
for (var k in targetProps) start[k] = parseFloat(getComputedStyle(el)[k]) || 0;
function step() {
var elapsed = Date.now() - startTime;
var progress = Math.min(elapsed / duration, 1);
// 線性 easing,可替換為 easeInOutQuad 等
for (var k in targetProps) {
var val = start[k] + (targetProps[k] - start[k]) * progress;
el.style[k] = (k === "opacity") ? val : val + "px";
}
if (progress < 1) requestAnimationFrame(step);
else if (callback) callback();
}
requestAnimationFrame(step);
}
// 使用
animate(document.getElementById("box"), { left: 300, opacity: 0.5 }, 800, null, function() {
console.log("動畫結束");
});
優勢:requestAnimationFrame 替代 setInterval,幀率與屏幕刷新同步,性能更好;支持多屬性並行動畫、緩動函數、完成回調。
===(整數像素)或閾值比較(浮點/透明度)。從「手寫 setInterval 移動盒子」到「封裝 requestAnimationFrame 通用動畫引擎」,是前端工程師從入門到進階的必經之路。建議先手寫基礎版體會坑點,再引入 GSAP、Anime.js 等成熟庫應對生產複雜動畫。