用 JavaScript 做動畫(位移、伸縮、淡入淡出)是每個前端的必修課,也是 bug 最集中的地方。本文把單物件與多物件動畫的常見問題逐一列出,每個都附上錯誤寫法與修正,最後收斂成一個可重複使用的完整框架。
錯誤寫法:
function startMove() {
var timer = null;
var div1 = document.getElementById("div1");
if (div1.offsetLeft == 300) {
clearInterval(timer);
} else {
timer = setInterval(function () {
div1.style.left = div1.offsetLeft + 10 + "px";
}, 30)
}
}
原意是「讓 div1 移動到 300px 然後停下」,但 if 不是迴圈,它只在 startMove 被呼叫的那一刻判斷一次。此時 div1 必然還沒到 300px,所以走 else 開了定時器;之後 if 再也不會被執行,定時器永遠停不下來,方塊會一路飛出畫面。
正確寫法是把判斷放進定時器的回呼裡,讓它每一幀都檢查:
var timer = null; // 必須在函式外面,否則無法被 clearInterval 共用
function startMove() {
var div1 = document.getElementById("div1");
timer = setInterval(function () {
if (div1.offsetLeft == 300) {
clearInterval(timer);
}
div1.style.left = div1.offsetLeft + 10 + "px";
}, 30)
}
錯誤寫法:
function startMove() {
var speed = 1;
var timer = null; // ← 問題就在這一行
var oDiv1 = document.getElementById("div1");
clearInterval(timer);
timer = setInterval(function () {
if (oDiv1.offsetLeft >= 300) {
clearInterval(timer);
} else {
oDiv1.style.left = oDiv1.offsetLeft + speed + "px";
}
}, 30)
}
原意是「連續點擊開始鈕時方塊會加速,因為每點一次就多開一個定時器;所以在開新定時器前先關掉舊的」。邏輯正確,但 把 timer 放在函式內部就注定失敗:每次呼叫 startMove 都會產生一個新的區域 timer 變數(也就是一個新的閉包),彼此完全不相關。clearInterval(timer) 清的是這次剛宣告、值為 null 的變數,對上一次的定時器毫無作用。
修正就是把 timer 提到函式外面,成為共用狀態:
var timer = null;
function startMove() {
var speed = 1;
var oDiv1 = document.getElementById("div1");
clearInterval(timer);
timer = setInterval(function () {
if (oDiv1.offsetLeft >= 300) {
clearInterval(timer);
} else {
oDiv1.style.left = oDiv1.offsetLeft + speed + "px";
}
}, 30)
}
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<style type="text/css">
#div1 { width: 150px; height: 200px; background: burlywood; position: absolute; left: -150px; }
span { width: 20px; height: 60px; position: absolute; background: gold; right: -20px; top: 70px; }
</style>
<script>
window.onload = function () {
var oDiv1 = document.getElementById("div1");
oDiv1.onmouseover = function () { move(0); };
oDiv1.onmouseout = function () { move(-150); };
};
var timer = null;
function move(target) {
var oDiv1 = document.getElementById("div1");
var speed = 0;
if (oDiv1.offsetLeft < target) { speed = 10; } else { speed = -10; }
clearInterval(timer);
timer = setInterval(function () {
if (oDiv1.offsetLeft == target) {
clearInterval(timer);
} else {
oDiv1.style.left = oDiv1.offsetLeft + speed + "px";
}
}, 30);
}
</script>
</head>
<body>
<div id="div1"><span id="span1">分享到</span></div>
</body>
</html>
這裡有個改進重點:move 函式接收目標值 target,並依「現在位置 < 目標」決定速度正負。這樣同一個函式就能同時處理滑出與滑入,不必寫兩份。
但用 == 判斷是否到達目標是個隱形地雷。如果目前位置是 297,加上 10 就變成 307,永遠不會等於 300,定時器就不會停。實務上應該改用 >= 或 <=,或者用「可變速度」逼近(見後面的完整框架)。
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<style>
#div1 { width: 200px; height: 200px; background: red; position: absolute;
filter: alpha(opacity:30); opacity: 0.3; }
</style>
<script>
window.onload = function () {
var oDiv1 = document.getElementById("div1");
oDiv1.onmouseover = function () { move(100); };
oDiv1.onmouseout = function () { move(30); };
};
var timer = null;
var alpha = 30;
function move(target) {
var oDiv1 = document.getElementById("div1");
var speed = 0;
clearInterval(timer);
if (alpha < target) { speed = 10; } else { speed = -10; }
timer = setInterval(function () {
if (alpha == target) {
clearInterval(timer);
} else {
alpha += speed;
oDiv1.style.filter = "alpha(opacity:" + alpha + ")";
oDiv1.style.opacity = alpha / 100;
}
}, 30);
};
</script>
</head>
<body>
<div id="div1"></div>
</body>
</html>
兩個注意點:
alpha 變數來記錄目前狀態。這也是為什麼淡入淡出的動畫框架一定要把狀態存在外部變數或物件的自訂屬性上。filter: alpha(opacity=xx)(0-100),Chrome 與 Firefox 用 style.opacity(0-1)。範例同時設定兩者是最保險的做法。<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<style type="text/css">
#div1 { width: 100px; height: 100px; background: yellowgreen;
position: absolute; bottom: 0px; right: 0px; }
</style>
<script>
window.onscroll = function () {
var oDiv = document.getElementById("div1");
var scrollTop = document.documentElement.scrollTop || document.body.scrollTop;
move(document.documentElement.clientHeight - oDiv.offsetHeight + scrollTop);
};
var timer = null;
function move(target) {
var oDiv = document.getElementById("div1");
clearInterval(timer);
timer = setInterval(function () {
// 用「距離 / 10」做可變速度,會愈接近愈慢
var speed = (target - oDiv.offsetTop) / 10;
speed = speed > 0 ? Math.ceil(speed) : Math.floor(speed);
if (oDiv.offsetTop == target) {
clearInterval(timer);
} else {
oDiv.style.top = oDiv.offsetTop + speed + 'px';
}
}, 30)
};
</script>
</head>
<body style="height:2000px;">
<div id="div1"></div>
</body>
</html>
這裡首次出現了緩動(easing)的雛形:speed = (target - current) / 10。距離越遠速度越快、越近越慢,視覺上就有「拖曳感」。搭配 Math.ceil / Math.floor 是為了確保速度至少為 1,避免除法的結果在小數上無限逼近卻永遠到不了目標(0.5 取 ceil 變 1,確保會前進)。
三個並排的 div 要做各自獨立的伸縮動畫。若只用一個全域 timer,當 div1 還在縮小、div2 卻被滑入觸發了伸長動畫時,clearInterval(timer) 會把 div1 的定時器也一起取消,於是 div1 永遠縮不完。
解法是把計時器掛在每個元素自己身上:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<style>
div { width: 100px; height: 50px; background: yellow; margin: 10px; }
</style>
<script>
window.onload = function () {
var oDiv = document.getElementsByTagName('div');
for (var i = 0; i < oDiv.length; i++) {
oDiv[i].timer = null; // 每個元素各自持有計時器
oDiv[i].onmouseover = function () { move(300, this); };
oDiv[i].onmouseout = function () { move(100, this); };
}
};
function move(iTarget, oDiv) {
clearInterval(oDiv.timer); // 只清自己的
oDiv.timer = setInterval(function () {
var speed = (iTarget - oDiv.offsetWidth) / 5;
speed = speed > 0 ? Math.ceil(speed) : Math.floor(speed);
if (iTarget == oDiv.offsetWidth) {
clearInterval(oDiv.timer);
} else {
oDiv.style.width = oDiv.offsetWidth + speed + "px";
}
}, 30);
}
</script>
</head>
<body>
<div id="div1"></div>
<div id="div2"></div>
<div id="div3"></div>
</body>
</html>
同樣把 timer 與 alpha 都掛在元素上:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<style>
div { width: 200px; height: 200px; margin: 10px; background: yellow; float: left;
filter: alpha(opacity:30); opacity: 0.3; }
</style>
<script>
window.onload = function () {
var oDiv = document.getElementsByTagName('div');
for (var i = 0; i < oDiv.length; i++) {
oDiv[i].timer = null;
oDiv[i].alpha = 30;
oDiv[i].onmouseover = function () { move(100, this); };
oDiv[i].onmouseout = function () { move(30, this); };
}
};
function move(iTarget, obj) {
clearInterval(obj.timer);
obj.timer = setInterval(function () {
var speed = (iTarget - obj.alpha) / 30;
speed = speed > 0 ? Math.ceil(speed) : Math.floor(speed);
if (obj.alpha == iTarget) {
clearInterval(obj.timer);
} else {
obj.alpha += speed;
obj.style.filter = "alpha(opacity:" + obj.alpha + ")";
obj.style.opacity = obj.alpha / 100;
}
}, 30);
}
</script>
</head>
<body>
<div></div><div></div><div></div><div></div>
</body>
</html>
這裡出現一個新的關鍵問題:offsetWidth 包含 border 與 padding。
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<style>
div { width: 100px; height: 100px; margin: 10px; background: yellow;
float: left; border: 10px solid black; }
</style>
<script>
window.onload = function () {
var oDiv1 = document.getElementById('div1');
var oDiv2 = document.getElementById('div2');
oDiv1.timer = null;
oDiv2.timer = null;
oDiv1.onmouseover = function () { move(this, 400, 'height'); };
oDiv1.onmouseout = function () { move(this, 100, 'height'); };
oDiv2.onmouseover = function () { move(this, 400, 'width'); };
oDiv2.onmouseout = function () { move(this, 100, 'width'); };
};
function getStyle(obj, name) {
if (obj.currentStyle) {
return obj.currentStyle[name]; // IE
} else {
return getComputedStyle(obj, false)[name]; // 標準瀏覽器
}
};
function move(obj, iTarget, name) {
clearInterval(obj.timer);
obj.timer = setInterval(function () {
var cur = parseInt(getStyle(obj, name));
var speed = (iTarget - cur) / 30;
speed = speed > 0 ? Math.ceil(speed) : Math.floor(speed);
if (cur == iTarget) {
clearInterval(obj.timer);
} else {
obj.style[name] = cur + speed + "px";
}
}, 30);
};
</script>
</head>
<body>
<div id="div1"></div>
<div id="div2"></div>
</body>
</html>
offsetWidth 回傳的是「內容寬 + padding + border + 水平捲軸寬」,不包含 margin。所以在 obj.style.width = obj.offsetWidth - 1 + "px" 這句中,如果元素的 border 是 10px(左右共 20px),offsetWidth 其實是 style.width + 20。結果這行程式變成:
style.width = (style.width + 20) - 1 = style.width + 19
本想讓圖片以 1px 逐步縮小,實際上反而每幀放大 19px。解法就是不要讀 offsetWidth,改用 getStyle 讀 computed width。
getComputedStyle 與 currentStyle 取到的值都是字串(如 "100px"),必須用 parseInt 或 parseFloat 轉成數字才能做運算,否則會發生字串串接("100" + 10 得到 "10010")。
把上面的經驗全部整合,並加上 opacity 的處理:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<style>
#div1 { width: 200px; height: 200px; margin: 20px; background: yellow;
border: 5px solid black; filter: alpha(opacity:30); opacity: 0.3; }
</style>
<script>
window.onload = function () {
var oDiv1 = document.getElementById('div1');
oDiv1.timer = null;
oDiv1.onmouseover = function () { move(this, 100, 'opacity'); };
oDiv1.onmouseout = function () { move(this, 30, 'opacity'); };
};
function getStyle(obj, name) {
if (obj.currentStyle) {
return obj.currentStyle[name];
} else {
return getComputedStyle(obj, false)[name];
}
};
function move(obj, iTarget, name) {
clearInterval(obj.timer);
obj.timer = setInterval(function () {
var cur = 0;
if (name == 'opacity') {
// opacity 的 computed 值是 0~1 的小數,轉成 0~100 整數比較好算
cur = Math.round(parseFloat(getStyle(obj, name)) * 100);
} else {
cur = parseInt(getStyle(obj, name));
}
var speed = (iTarget - cur) / 30;
speed = speed > 0 ? Math.ceil(speed) : Math.floor(speed);
if (cur == iTarget) {
clearInterval(obj.timer);
} else {
if (name == 'opacity') {
obj.style.opacity = (cur + speed) / 100;
obj.style.filter = 'alpha(opacity:' + (cur + speed) + ')';
} else {
obj.style[name] = cur + speed + "px";
}
}
}, 30);
};
</script>
</head>
<body>
<div id="div1"></div>
</body>
</html>
這個框架的設計要點:
(target - cur) / 30 讓移動有自然的加減速。理解這些原理很有價值——它教你 DOM 操作、reflow、定時器與閉包的實際行為。但新專案不應該再手寫 setInterval 動畫,原因有三:
現代的標準做法:
/* CSS transition:最簡單,適合狀態切換 */
.box {
width: 100px;
transition: width 0.3s ease-in-out, opacity 0.3s;
}
.box:hover { width: 300px; opacity: 1; }
/* 淡入淡出用 opacity + visibility,不要用 display */
.fade { opacity: 0; transition: opacity .3s; }
.fade.show { opacity: 1; }
/* Web Animations API:需要 JS 控制時用這個 */
element.animate(
[{ transform: 'translateX(0)' }, { transform: 'translateX(300px)' }],
{ duration: 300, easing: 'ease-in-out', fill: 'forwards' }
);
/* requestAnimationFrame:需要逐幀自訂邏輯時 */
function animate() {
// 每幀執行,自動與螢幕刷新同步
requestAnimationFrame(animate);
}
最後加上無障礙考量:所有動畫都應該尊重 prefers-reduced-motion,讓對動態敏感的使用者關閉效果:
@media (prefers-reduced-motion: reduce) {
* { animation-duration: 0.01ms !important; transition-duration: 0.01ms !important; }
}
把本文的問題當成「理解瀏覽器如何運作」的教材,再用水準之上的工具去實作,才是這篇筆記最大的價值。