拖曳看似簡單,真正寫起來卻牽涉三件事:跨瀏覽器的事件綁定寫法、滑鼠座標與元素位置的換算、以及拖放期間事件監聽的掛上與卸除。以下逐層拆解。
/**
* 綁定事件
* @param {Node} node 目標節點
* @param {String} eventType 事件類型
* @param {Function} callback 回呼函式
* @return {Function} 回傳回呼函式的參照,供日後解綁使用
*/
function bindEvent(node, eventType, callback) {
if (node.attachEvent) { // IE
if (eventType.indexOf('on')) eventType = 'on' + eventType;
node.attachEvent(eventType, callback);
} else { // 標準瀏覽器
if (!eventType.indexOf('on')) eventType = eventType.substring(2);
node.addEventListener(eventType, callback, false);
}
return callback;
}
/**
* 解除事件
*/
function removeEvent(node, eventType, callback) {
if (node.detachEvent) {
if (eventType.indexOf('on')) eventType = 'on' + eventType;
node.detachEvent(eventType, callback);
} else {
if (!eventType.indexOf('on')) eventType = eventType.substring(2);
node.removeEventListener(eventType, callback, false);
}
}
回傳 callback 參照是個小技巧——因為 removeEventListener 必須傳入「同一個函式物件」才能成功移除,把參照暴露出來才不會失聯。
/**
* 讓指定元素可以被拖動
* @param {Node} dragger 要拖曳的元素
* @return {Function} 呼叫它可取消拖曳功能
*/
function canDrag(dragger) {
bindEvent(dragger, 'onmousedown', function(e) {
e = e || window.event; // 兼容 IE 的事件物件
// 兼容座標屬性
var pageX = e.clientX || e.pageX;
var pageY = e.clientY || e.pageY;
// 兼容樣式物件
var style = dragger.currentStyle || window.getComputedStyle(dragger, null);
// 未設定 left / top 時,IE 下預設值為 auto,parseInt 會得到 NaN
var offX = parseInt(style.left) || 0;
var offY = parseInt(style.top) || 0;
// 滑鼠位置與元素左上角之間的偏移量
var offXL = pageX - offX;
var offYL = pageY - offY;
// 掛上拖動與結束拖動的監聽
if (!dragger.onDrag) {
dragger.onDrag = bindEvent(document, 'onmousemove', function(e) {
e = e || window.event;
var x = e.clientX || e.pageX;
var y = e.clientY || e.pageY;
dragger.style.left = (x - offXL) + 'px';
dragger.style.top = (y - offYL) + 'px';
});
dragger.onDragEnd = bindEvent(document, 'onmouseup', function() {
// 釋放監聽
removeEvent(document, 'onmousemove', dragger.onDrag);
removeEvent(document, 'onmouseup', dragger.onDragEnd);
try {
delete dragger.onDrag; // 兼容 Firefox
delete dragger.onDragEnd;
} catch (e) {
dragger.removeAttribute('onDrag'); // 兼容 IE6
dragger.removeAttribute('onDragEnd');
}
});
}
});
// 回傳取消拖曳的函式
return function() {
removeEvent(document, 'onmousemove', dragger.onDrag);
removeEvent(document, 'onmouseup', dragger.onDragEnd);
try {
delete dragger.onDrag;
delete dragger.onDragEnd;
} catch (e) {
dragger.removeAttribute('onDrag');
dragger.removeAttribute('onDragEnd');
}
};
}
如果綁在被拖的元素上,滑鼠一旦移得太快跑出元素範圍,就會收不到 mousemove 事件,拖曳會「卡住」。綁在 document 上,無論游標到哪裡都能持續追蹤。
不做這個計算的話,按下元素左上角拖動還好,但若從元素中間按下,元素就會「跳」到讓游標對齊左上角的位置。先算出「游標與元素左上角的距離」,之後每次移動都用新座標減掉它,元素才會穩定地跟在游標後面。
mousemove 觸發頻率極高,若拖完還掛在 document 上,會持續消耗效能,也會影響頁面上其他互動。松手就拆掉,是基本禮儀。
left 與 top 只有在 position 不是 static 時才有效:
.draggable { position: absolute; }
拖曳時瀏覽器預設會去選取文字,畫面會出現藍色反白。在 mousedown 時阻止即可:
e.preventDefault ? e.preventDefault() : (e.returnValue = false);
var pending = false, latestX, latestY;
document.addEventListener('mousemove', function(e) {
latestX = e.clientX; latestY = e.clientY;
if (pending) return;
pending = true;
requestAnimationFrame(function() {
pending = false;
dragger.style.transform = 'translate(' + latestX + 'px,' + latestY + 'px)';
});
});
用 transform 而非 left/top 也更好——前者只觸發合成,不會引起重排。
手機沒有滑鼠,需要額外處理 touchstart / touchmove / touchend,並在 CSS 上設 touch-action: none 避免手勢被瀏覽器攔截。
如果只是要「把 A 拖到 B 上」這類操作,直接用 HTML5 的原生 API 會省事得多:
item.draggable = true;
item.addEventListener('dragstart', e => e.dataTransfer.setData('text/plain', item.id));
target.addEventListener('dragover', e => e.preventDefault());
target.addEventListener('drop', e => {
e.preventDefault();
target.appendChild(document.getElementById(e.dataTransfer.getData('text/plain')));
});
需要更複雜的排序、動畫與觸控支援時,SortableJS 或 dnd-kit 這類函式庫會比自己維護省下大量時間。