可拖曳的浮動視窗是許多網頁應用常見的互動效果。本文以純 JavaScript 實作一個可拖動的 DIV,並詳細拆解每個步驟的原理,幫助你真正理解拖曳背後的運作機制。
拖曳本質上是三個事件的接力:
1. 在 DIV 上捕捉 mousedown(按下)事件,記錄起始位置。
2. 在 document 上捕捉 mousemove(移動)事件,持續更新位置。
3. 在放開滑鼠時(mouseup)取消上述監聽,結束拖曳。
整個拖曳函式可包成 Drag(id),並在內部封裝一組座標工具物件 page,用來統一處理不同瀏覽器的座標取得:
function Drag(id) {
var $ = function (flag) { return document.getElementById(flag); };
$(id).onmousedown = function (e) {
var d = document;
var page = {
event: function (evt){ var ev = evt || window.event; return ev; },
pageX: function (evt){ var e=this.event(evt); return e.pageX || (e.clientX + document.body.scrollLeft - document.body.clientLeft); },
pageY: function (evt){ var e=this.event(evt); return e.pageY || (e.clientY + document.body.scrollTop - document.body.clientTop); },
layerX: function (evt){ var e=this.event(evt); return e.layerX || e.offsetX; },
layerY: function (evt){ var e=this.event(evt); return e.layerY || e.offsetY; }
};
var x = page.layerX(e);
var y = page.layerY(e);
if (dv.setCapture) { dv.setCapture(); }
else if (window.captureEvents) { window.captureEvents(Event.MOUSEMOVE | Event.MOUSEUP); }
d.onmousemove = function (e) {
var tx = page.pageX(e) - x;
var ty = page.pageY(e) - y;
dv.style.left = tx + "px";
dv.style.top = ty + "px";
};
d.onmouseup = function () {
if (dv.releaseCapture) { dv.releaseCapture(); }
else if (window.releaseEvents) { window.releaseEvents(Event.MOUSEMOVE | Event.MOUSEUP); }
d.onmousemove = null;
d.onmouseup = null;
};
};
}
page 物件中,event 負責取得滑鼠事件;pageX、pageY 取得滑鼠在文件中的座標;layerX、layerY 則取得滑鼠距離 DIV 邊框的距離。這組工具讓程式能相容不同瀏覽器的座標屬性差異。
在 mousedown 時,先記錄滑鼠相對 DIV 的偏移量 x、y,接著透過 setCapture 或 captureEvents 捕捉後續的移動與放開事件。到了 mousemove,用「目前滑鼠座標減去起始偏移」算出 DIV 應在的位置 tx、ty,再寫入 style.left 與 style.top,DIV 便會跟著滑鼠移動。
這是很多人會卡住的地方。x、y 代表滑鼠按下的位置距 DIV 邊框的距離。若不減去,DIV 的左上角會直接對齊滑鼠箭頭,造成拖曳瞬間「跳一下」、游標偏到角落的突兀感。減去偏移量後,就能保持按下時的相對位置,拖曳起來更自然順手。
在 mouseup 時,除了釋放事件捕獲,最重要的是把 document.onmousemove 與 document.onmouseup 設為 null,取消監聽,拖曳才會停止。否則放開滑鼠後 DIV 仍會黏著游標移動。
這個範例完整示範了以原生事件實作拖曳的核心邏輯。掌握「按下記錄偏移、移動更新座標、放開解除監聽」這三步,就能延伸做出浮動視窗、拖曳排序等更進階的互動。JavaScript 的靈活與跨平台特性,讓這類效果在 PC 與行動裝置上都能派上用場。