讓頁面上的圖片或方塊可以用滑鼠拖著走,是很多互動效果的地基。關鍵有兩點:正確綁定事件、以及阻止瀏覽器的預設拖曳行為。
<img> 元素在瀏覽器中有原生的拖曳行為——按住圖片拖動會出現「拖曳 ghost image」,滑鼠移動時反而觸發不到我們的 mousemove。所以必須在 mousedown 時阻止預設行為:
if (e.preventDefault) e.preventDefault(); else e.returnValue = false; // 舊 IE
另一個等效做法是直接給 img 加上 draggable="false" 屬性,或是在 CSS 上設 user-select: none 避免拖曳時選到文字。
<script language="javascript" type="text/javascript">
var isDrag = false;
function isIE() {
if (navigator.userAgent.indexOf("MSIE") > 0) { return true; }
else { return false; }
}
// 跨瀏覽器的事件綁定
function addListener(element, e, fn) {
if (isIE()) { element.attachEvent("on" + e, fn); }
else { element.addEventListener(e, fn, false); }
}
function drag(e) {
var e = e || window.event;
var element = e.srcElement || e.target;
// 阻止圖片的原生拖曳
if (e.preventDefault) e.preventDefault();
else e.returnvalue = false;
isDrag = true;
// 記錄滑鼠與元素左上角之間的偏移量
var relLeft = e.clientX - parseInt(element.style.left);
var relTop = e.clientY - parseInt(element.style.top);
element.onmouseup = function() { isDrag = false; };
document.onmousemove = function(e_move) {
var e_move = e_move || window.event;
if (isDrag) {
element.style.left = (e_move.clientX - relLeft) + "px";
element.style.top = (e_move.clientY - relTop) + "px";
return false;
}
}
}
window.onload = function() {
var element = document.getElementById("elimg");
var element2 = document.getElementById("eldiv");
addListener(element, "mousedown", drag);
addListener(element2, "mousedown", drag);
}
</script>
<div id="eldiv" style="width:140px;height:100px;background:#EEE;
position:absolute;left:117px;top:124px"></div>
<img id="elimg" style="left:609px;top:113px;position:absolute"
src="https://www.cnit618.com/template/images/logo.gif" />
偏移量(relLeft / relTop)是整個效果的關鍵。如果直接設 element.style.left = e.clientX,元素左上角會瞬間跳到滑鼠位置,感覺像是「抓住中心點突然對齊」。減去一開始的偏移量之後,元素與滑鼠的相對位置就保持不變,拖起來才是自然的。
事件綁定在 document 而非 element 上也很重要。滑鼠拖很快時會移出元素範圍,若 mousemove 掛在元素上就會中斷;掛在 document 上則無論滑鼠到哪裡都能持續追蹤。
returnvalue 拼錯了:正確的屬性名是 returnValue(大寫 V)。這個字母錯誤會讓舊 IE 的降級分支永遠失效。parseInt(element.style.left) 可能得到 NaN:若元素的 left 尚未設定為內聯樣式(例如由 CSS class 指定),style.left 會是空字串,parseInt("") 得到 NaN,之後所有計算都失效。應改用 parseFloat(getComputedStyle(el).left)。indexOf("MSIE") 無法辨識以 Trident 標示的 IE11。標準做法是功能偵測:if (element.addEventListener)。onmouseup 不會觸發,元素會「黏」在滑鼠上。
(function () {
var dragging = null; // 目前正在拖曳的元素
var offsetX = 0, offsetY = 0;
function onPointerDown(e) {
if (e.button !== 0) return; // 只處理左鍵
dragging = e.currentTarget;
dragging.setPointerCapture(e.pointerId); // 關鍵:捕獲指標
var rect = dragging.getBoundingClientRect();
offsetX = e.clientX - rect.left;
offsetY = e.clientY - rect.top;
dragging.classList.add("dragging");
e.preventDefault();
}
function onPointerMove(e) {
if (!dragging) return;
var x = e.clientX - offsetX;
var y = e.clientY - offsetY;
// 邊界鉗制,避免拖出視窗
var maxX = window.innerWidth - dragging.offsetWidth;
var maxY = window.innerHeight - dragging.offsetHeight;
x = Math.min(Math.max(0, x), maxX);
y = Math.min(Math.max(0, y), maxY);
dragging.style.left = x + "px";
dragging.style.top = y + "px";
}
function onPointerUp(e) {
if (!dragging) return;
dragging.classList.remove("dragging");
dragging.releasePointerCapture(e.pointerId);
dragging = null;
}
document.querySelectorAll("[draggable]").forEach(function (el) {
el.style.position = "absolute";
el.addEventListener("pointerdown", onPointerDown);
});
document.addEventListener("pointermove", onPointerMove);
document.addEventListener("pointerup", onPointerUp);
})();
用 transform: translate() 取代 left/top 還能觸發 GPU 合成,拖起來更順:
dragging.style.transform = "translate(" + x + "px," + y + "px)";
pointerdown/pointermove/pointerup 統一了滑鼠、觸控與手寫筆,不必再為行動裝置另外寫 touchstart 分支。setPointerCapture 則自動解決了「滑鼠移出元素或視窗後拖曳中斷」的問題,這在舊寫法中需要額外處理。
另外別忘了無障礙考量:純靠拖曳的功能對只用鍵盤的使用者完全無法操作。若元素有意義(例如排序、移動面板),應提供鍵盤替代操作(方向鍵移動)與 role、aria-label 等標示;若純屬裝飾性互動,則可略。