DIV CSS 佈局教程網

JS 實作滑鼠拖曳元素:跨瀏覽器事件綁定與 preventDefault 的用法
編輯:關於JavaScript     

讓頁面上的圖片或方塊可以用滑鼠拖著走,是很多互動效果的地基。關鍵有兩點:正確綁定事件、以及阻止瀏覽器的預設拖曳行為。

一、為什麼一定要 preventDefault

<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 上則無論滑鼠到哪裡都能持續追蹤。

四、這份寫法的問題

  1. returnvalue 拼錯了:正確的屬性名是 returnValue(大寫 V)。這個字母錯誤會讓舊 IE 的降級分支永遠失效。
  2. parseInt(element.style.left) 可能得到 NaN:若元素的 left 尚未設定為內聯樣式(例如由 CSS class 指定),style.left 會是空字串,parseInt("") 得到 NaN,之後所有計算都失效。應改用 parseFloat(getComputedStyle(el).left)。
  3. UA 判斷不嚴謹:indexOf("MSIE") 無法辨識以 Trident 標示的 IE11。標準做法是功能偵測:if (element.addEventListener)。
  4. 沒有邊界限制:元素可以被拖到視窗外消失,實務上應加上座標鉗制。
  5. 拖曳結束後 isDrag 未必復位:滑鼠在視窗外放開時 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)";

六、Pointer Events 的優勢

pointerdown/pointermove/pointerup 統一了滑鼠、觸控與手寫筆,不必再為行動裝置另外寫 touchstart 分支。setPointerCapture 則自動解決了「滑鼠移出元素或視窗後拖曳中斷」的問題,這在舊寫法中需要額外處理。

另外別忘了無障礙考量:純靠拖曳的功能對只用鍵盤的使用者完全無法操作。若元素有意義(例如排序、移動面板),應提供鍵盤替代操作(方向鍵移動)與 role、aria-label 等標示;若純屬裝飾性互動,則可略。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved