下面這些都是日常開發會反覆用到的小工具:Cookie 讀寫、事件綁定、按 class 取值、隨機數、時間格式化、拖曳、滾輪,以及兩種緩動運動函式。與每次重寫,不如攢成一份自己的工具箱。
function setCookie(name, value, iDay) {
if (iDay !== false) {
var oDate = new Date();
oDate.setDate(oDate.getDate() + iDay);
document.cookie = name + '=' + value + ';expires=' + oDate + ';path=/';
} else {
document.cookie = name + '=' + value;
}
}
function getCookie(name) {
var arr = document.cookie.split('; ');
for (var i = 0; i < arr.length; i++) {
var arr2 = arr[i].split('=');
if (arr2[0] == name) { return arr2[1]; }
}
return '';
}
function removeCookie(name) {
setCookie(name, 'a', -1); // 過期日設為昨天
}
function myAddEvent(obj, ev, fn) {
obj.attachEvent ? obj.attachEvent('on' + ev, fn) : obj.addEventListener(ev, fn, false);
}
function myDelEvent(obj, ev, fn) {
obj.detachEvent ? obj.detachEvent('on' + ev, fn) : obj.removeEventListener(ev, fn, false);
}
function bindEvent(obj, ev, fn) {
obj.addEventListener ? obj.addEventListener(ev, fn, false) : obj.attachEvent('on' + ev, fn);
}
function unbindEvent(obj, ev, fn) {
obj.removeEventListener ? obj.removeEventListener(ev, fn, false) : obj.detachEvent('on' + ev, fn);
}
// 以 class 名稱取得元素集合
function getByClass(oParent, sClass) {
var aEle = oParent.getElementsByTagName('*');
var re = new RegExp('\\b' + sClass + '\\b', 'i');
var aResult = [];
for (var i = 0; i < aEle.length; i++) {
if (re.test(aEle[i].className)) { aResult.push(aEle[i]); }
}
return aResult;
}
// 傳回 n ~ m 之間的隨機小數
function rnd(n, m) {
return Math.random() * (m - n) + n;
}
// 時間戳(秒)轉 YYYY-MM-DD HH:MM:SS
function time2date(t) {
function d(n) { return n < 10 ? '0' + n : '' + n; }
var oDate = new Date(t * 1000);
return oDate.getFullYear() + '-' + d(oDate.getMonth() + 1) + '-' + d(oDate.getDate())
+ ' ' + d(oDate.getHours()) + ':' + d(oDate.getMinutes()) + ':' + d(oDate.getSeconds());
}
// 時間戳(秒)轉 YYYY-MM-DD
function time2day(t) {
function d(n) { return n < 10 ? '0' + n : '' + n; }
var oDate = new Date(t * 1000);
return oDate.getFullYear() + '-' + d(oDate.getMonth() + 1) + '-' + d(oDate.getDate());
}
function drag(objEv, objMove, fnMoveCallBack) {
var disX = 0, disY = 0;
objEv.onmousedown = function (ev) {
var oEvent = ev || event;
disX = (document.documentElement.scrollLeft || document.body.scrollLeft) + oEvent.clientX - objMove.offsetLeft;
disY = (document.documentElement.scrollTop || document.body.scrollTop) + oEvent.clientY - objMove.offsetTop;
if (objEv.setCapture) {
objEv.onmousemove = fnMove;
objEv.onmouseup = fnUp;
objEv.setCapture(); // 滑鼠移出視窗仍能繼續拖
} else {
document.onmousemove = fnMove;
document.onmouseup = fnUp;
return false;
}
};
function fnMove(ev) {
var oEvent = ev || event;
var l = (document.documentElement.scrollLeft || document.body.scrollLeft) + oEvent.clientX - disX;
var t = (document.documentElement.scrollTop || document.body.scrollTop) + oEvent.clientY - disY;
fnMoveCallBack(l, t);
}
function fnUp() {
this.onmousemove = null;
this.onmouseup = null;
if (this.releaseCapture) this.releaseCapture();
}
}
function mouseScroll(obj, fnCallBack) {
bindEvent(obj, 'mousewheel', fnScroll);
bindEvent(obj, 'DOMMouseScroll', fnScroll);
function fnScroll(ev) {
var oEvent = ev || event;
var bDown;
if (oEvent.wheelDelta) {
bDown = oEvent.wheelDelta < 0; // IE / Chrome
} else {
bDown = oEvent.detail > 0; // Firefox
}
fnCallBack(bDown);
if (oEvent.preventDefault) oEvent.preventDefault();
return false;
}
}
這兩個函式是緩動動畫的核心:給定起始值 cur、目標值 target,在 fnDo 中套用每個 frame 的插值,結束時呼叫 fnEnd。
// 擺動:速度先加後減,帶有回彈感
zns.site.fx.swing = function (obj, cur, target, fnDo, fnEnd, acc) {
if (!acc) acc = 0.1;
var now = {};
var x = 0; // 0 ~ 100 的進度
if (!obj.__swing_v) obj.__swing_v = 0;
clearInterval(obj.timer);
obj.timer = setInterval(fnMove, 20);
function fnMove() {
if (x < 50) { obj.__swing_v += acc; } else { obj.__swing_v -= acc; }
x += obj.__swing_v;
for (var i in cur) {
now[i] = (target[i] - cur[i]) * x / 100 + cur[i];
}
if (fnDo) fnDo.call(obj, now);
if (Math.abs(100 - x) < 1) {
clearInterval(obj.timer);
if (fnEnd) fnEnd.call(obj, target);
obj.__swing_v = 0;
}
}
};
// 彈性:以距離與阻尼係數逼近目標,會有幾次來回震盪
zns.site.fx.flex = function (obj, cur, target, fnDo, fnEnd, fs, ms) {
var MAX_SPEED = 16;
if (!fs) fs = 6; // 彈性係數
if (!ms) ms = 0.75; // 阻尼
var now = {};
var x = 0;
if (!obj.__flex_v) obj.__flex_v = 0;
clearInterval(obj.timer);
obj.timer = setInterval(fnMove, 20);
function fnMove() {
obj.__flex_v += (100 - x) / fs;
obj.__flex_v *= ms;
if (Math.abs(obj.__flex_v) > MAX_SPEED) {
obj.__flex_v = obj.__flex_v > 0 ? MAX_SPEED : -MAX_SPEED;
}
x += obj.__flex_v;
for (var i in cur) {
now[i] = (target[i] - cur[i]) * x / 100 + cur[i];
}
if (fnDo) fnDo.call(obj, now);
if (Math.abs(obj.__flex_v) < 1 && Math.abs(100 - x) < 1) {
clearInterval(obj.timer);
if (fnEnd) fnEnd.call(obj, target);
obj.__flex_v = 0;
}
}
};
這份工具箱的寫法帶有明顯的時代痕跡:attachEvent、setCapture、DOMMouseScroll 都是為相容 IE8 以下的分支。在只需要支援現代瀏覽器的專案裡,這些判斷都可以拿掉,程式碼會短很多——addEventListener、element.setPointerCapture()、wheel 事件已經是標準做法。
另外,getByClass 現在可以直接用 querySelectorAll('.' + sClass) 取代,setCookie 建議補上 encodeURIComponent 編碼與 SameSite 屬性。動畫方面,setInterval 逐格改 style 會讓主執行緒忙於計算,改用 CSS transition 或 Web Animations API 通常更順,也能交給合成器執行。這份程式留著當作理解原理的教材很不錯,實際專案則建議挑選其中幾個函式,用現代 API 重寫後再放進自己的工具庫。