讓頁面上的方塊可以用滑鼠拖著移動,是彈出視窗、浮動面板、看板元件的共同基礎。本文整理三種由簡到繁的實作,並說明各自的取捨。
用一個全域變數記錄「目前正在拖的元素」,再用兩個全域事件處理移動與放開:
<!DOCTYPE HTML>
<html>
<head>
<style type="text/css">
#main div {
position: absolute;
width: 220px; height: 150px;
border: 1px solid #999;
}
</style>
<script type="text/javascript">
var a; // 目前拖曳中的元素
document.onmouseup = function () {
if (!a) return;
a = "";
};
document.onmousemove = function (d) {
if (!a) return;
d = d || event; // 兼容 IE
a.style.left = (d.clientX - b) + "px";
a.style.top = (d.clientY - c) + "px";
};
function $(o, e) {
a = o;
b = e.clientX - parseInt(a.style.left); // 記錄滑鼠與元素左上角的距離
c = e.clientY - parseInt(a.style.top);
}
</script>
</head>
<body>
<div id="main">
<div style="left:100px;top:100px;background:#fc9;" onmousedown="$(this,event)">1</div>
<div style="left:400px;top:100px;background:#9cf;" onmousedown="$(this,event)">2</div>
<div style="left:700px;top:100px;background:#f9c;" onmousedown="$(this,event)">3</div>
<div style="left:100px;top:300px;background:#9fc;" onmousedown="$(this,event)">4</div>
<div style="left:400px;top:300px;background:#c9f;" onmousedown="$(this,event)">5</div>
<div style="left:700px;top:300px;background:#cf9;" onmousedown="$(this,event)">6</div>
</div>
</body>
</html>
整段的核心觀念是 偏移量補償:在 mousedown 時記下「滑鼠位置 − 元素左上角位置」,之後移動時用「目前滑鼠位置 − 這個偏移量」當作新座標。少了這一步,元素左上角會瞬間吸附到滑鼠上,拖起來很不自然。
另一個關鍵設計是把 mousemove 掛在 document 上而非元素上。滑鼠拖得快時會跑出元素範圍,掛在元素上就會中斷。
實作一有個隱患:parseInt(a.style.left) 只能讀到內聯樣式。若 left 是由 CSS class 指定的,style.left 會是空字串,parseInt("") 得到 NaN,之後所有計算全部失效。實作二修正了這一點:
<!DOCTYPE HTML>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>拖曳測試</title>
<style type="text/css">
#test {
width: 200px; height: 200px;
background: pink; cursor: move;
position: absolute; left: 100px; top: 100px;
}
</style>
</head>
<body>
<div id="test"></div>
<script type="text/javascript">
var obj = document.getElementById("test");
var b;
obj.onmousedown = function (e) {
b = true;
// 用 computed style 取得實際套用的 left/top,而非只看內聯樣式
var divLeft = parseFloat(window.getComputedStyle
? window.getComputedStyle(obj, null).left
: obj.currentStyle.left);
var divTop = parseFloat(window.getComputedStyle
? window.getComputedStyle(obj, null).top
: obj.currentStyle.top);
var e = e || event;
var divX = e.clientX - divLeft; // 滑鼠與元素邊界的距離
var divY = e.clientY - divTop;
document.onmousemove = function (e) {
if (b) {
var e = e || event; // 兼容 IE8 及以下
obj.style.left = e.clientX - divX + "px";
obj.style.top = e.clientY - divY + "px";
}
}
}
document.onmouseup = function () { b = false; }
</script>
</body>
</html>
這裡用了 window.getComputedStyle(標準)與 obj.currentStyle(IE 專屬)的雙路徑,並用 parseFloat 而非 parseInt,避免小數座標被無條件捨去造成累積誤差。
實務上通常不希望整個方塊都能拖——裡面的輸入框、按鈕就沒辦法正常點擊了。做法是把 mousedown 監聽掛在一個特定的「標題列」上,而不是容器本身:
<style>
*{margin:0; padding:0}
#testBox {
width: 300px; height: 300px;
background: red;
position: absolute; left: 0; top: 0;
}
#test {
width: 200px; height: 200px;
background: pink;
margin: 30px;
}
#handle {
background: #369; color: #fff;
padding: 4px; cursor: move;
user-select: none; /* 避免拖曳時選到文字 */
}
</style>
<div id="testBox">
<div id="handle">在這裡才能移動</div>
<div id="test">
<input type="text" placeholder="這裡可以正常輸入">
</div>
</div>
<script>
var box = document.getElementById("testBox");
var handle = document.getElementById("handle");
var dragging = false, offsetX = 0, offsetY = 0;
handle.addEventListener("mousedown", function (e) {
dragging = true;
offsetX = e.clientX - box.offsetLeft;
offsetY = e.clientY - box.offsetTop;
e.preventDefault(); // 防止選取文字與原生拖曳
});
document.addEventListener("mousemove", function (e) {
if (!dragging) return;
box.style.left = (e.clientX - offsetX) + "px";
box.style.top = (e.clientY - offsetY) + "px";
});
document.addEventListener("mouseup", function () { dragging = false; });
</script>
關鍵是把監聽掛在 handle 上、把位置套用在 box 上,兩者分離。這也是所有對話框、浮動視窗元件的標準做法。
上述寫法都有一個共通缺陷:滑鼠在視窗外放開時,mouseup 不會觸發,於是 dragging 一直是 true,元素會「黏」在滑鼠上直到下次點擊。此外也都不支援觸控裝置。
用 Pointer Events 可以一次解決:
(function () {
var handle = document.getElementById("handle");
var box = document.getElementById("testBox");
var dragging = false, offsetX = 0, offsetY = 0;
handle.addEventListener("pointerdown", function (e) {
if (e.button !== 0) return;
dragging = true;
handle.setPointerCapture(e.pointerId); // 關鍵:捕獲指標
offsetX = e.clientX - box.offsetLeft;
offsetY = e.clientY - box.offsetTop;
handle.classList.add("dragging");
e.preventDefault();
});
handle.addEventListener("pointermove", function (e) {
if (!dragging) return;
// 邊界鉗制,避免拖出視窗
var maxX = window.innerWidth - box.offsetWidth;
var maxY = window.innerHeight - box.offsetHeight;
var x = Math.min(Math.max(0, e.clientX - offsetX), maxX);
var y = Math.min(Math.max(0, e.clientY - offsetY), maxY);
box.style.transform = "translate(" + x + "px," + y + "px)";
});
handle.addEventListener("pointerup", function (e) {
dragging = false;
handle.releasePointerCapture(e.pointerId);
handle.classList.remove("dragging");
});
})();
setPointerCapture 的效果是「在指標捕獲期間,所有事件都會導向這個元素」,因此滑鼠移出視窗、移到其他元素上都無所謂,放開時一定收得到 pointerup。
另外用 transform: translate() 取代 left/top,能觸發 GPU 合成層,拖曳時不會引起 layout reflow,流暢度明顯更好。若要搭配 CSS transition 做放開後的吸附動畫,也必須用 transform 才有效果。
user-select: none:拖曳時若選到文字會出現藍色高亮,視覺很糟。touch-action: none(在把柄上):否則行動裝置上觸控拖曳會與頁面捲動衝突。role、aria-describedby 說明操作方式;若純屬視覺偏好(例如浮動小工具的位置),則可視為裝飾性互動。localStorage,讓使用者下次來時位置還在。