jTimer 解決「按間隔執行任務,滿足條件自動停止」的常見需求。不同於 setInterval 需手動 clearInterval,jTimer 透過回傳值控制繼續/停止,語意更清晰。
(function($) {
$.extend({
timer: function(action, context, interval) {
var _timer;
if ($.isFunction(action)) {
(function() {
_timer = setInterval(function() {
// action 回傳 false 則停止
if (!action(context)) {
clearInterval(_timer);
}
}, interval);
})();
}
}
});
})(jQuery);
關鍵設計:action(context) 回傳 true 繼續,false 停止。context 物件可攜帶狀態(如計數器、座標),實現狀態保持。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jTimer Canvas 動畫示範</title>
<script src="jquery.min.js"></script>
<script src="jTimer.js"></script>
<style>
#wrap { display: table; margin: 0 auto; }
#cvs { display: table-cell; vertical-align: middle; }
</style>
</head>
<body>
<div id="wrap">
<canvas id="cvs" height="400" width="500"></canvas>
</div>
<script>
// 繪製單一圓弧段
function draw(x, y, r, startAngle, endAngle, counterclockwise) {
var cvs = document.getElementById("cvs");
var ctx = cvs.getContext("2d");
ctx.strokeStyle = "#f00";
ctx.beginPath();
ctx.arc(x, y, r, startAngle, endAngle, counterclockwise);
ctx.stroke();
}
// 動畫邏輯:回傳 true 繼續,false 停止
function drawRound(context) {
if (context.counterclockwise) {
// 逆時針:從 270° 遞減至 90°
draw(context.x, context.y, context.r,
context.start, context.start - Math.PI / 50,
context.counterclockwise);
context.start -= Math.PI / 50;
return context.start > 0.5 * Math.PI; // 未達終點繼續
} else {
// 順時針:從 0° 遞增至 180°
draw(context.x, context.y, context.r,
context.start, context.start + Math.PI / 50,
context.counterclockwise);
context.start += Math.PI / 50;
return context.start < Math.PI; // 未達終點繼續
}
}
$(function() {
// 逆時針內圈
$.timer(drawRound, {
x: 100, y: 100, r: 50,
start: 1.5 * Math.PI,
counterclockwise: true
}, 20);
// 順時針外圈
$.timer(drawRound, {
x: 100, y: 100, r: 60,
start: 0,
counterclockwise: false
}, 20);
});
</script>
</body>
</html>
| 參數 | 說明 |
|---|---|
action | 執行函式,接收 context,回傳 true/false 控制持續 |
context | 狀態物件,函式間共享,可存座標、角度、計數器等 |
interval | 間隔毫秒數 |
動畫場景建議使用 requestAnimationFrame,效能更好、幀率穩定:
function animate(context) {
if (!drawRound(context)) return; // 停止條件
requestAnimationFrame(() => animate(context));
}
animate({ x: 100, y: 100, r: 50, start: 1.5 * Math.PI, counterclockwise: true });