萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 實現 DIV 拖拽移動與彈出層核心原理完整代碼

核心原理:絕對定位 + 滑鼠事件數學

將目標元素 position: absolute,記錄滑鼠按下時的 (pageX, pageY) 與元素初始 (offsetLeft, offsetTop) 的差值。移動時:新位置 = 當前滑鼠位置 - 差值。

完整可運行代碼

<!DOCTYPE html>
<html lang="zh-TW">
<head>
<meta charset="UTF-8">
<title>jQuery 拖拽演示</title>
<style>
.moveBar {
    position: absolute;
    width: 250px;
    height: 300px;
    background: #666;
    border: solid 1px #000;
    border-radius: 8px;
    box-shadow: 0 4px 12px rgba(0,0,0,0.15);
}
#banner {
    background: #52CCCC;
    cursor: move;
    padding: 10px;
    color: #333;
    font-weight: bold;
    border-radius: 8px 8px 0 0;
    user-select: none; /* 禁止選中文字 */
}
.content {
    padding: 15px;
    color: white;
}
.footer {
    position: fixed;
    bottom: 0;
    width: 100%;
    text-align: center;
    padding: 10px;
    background: #f5f5f5;
    border-top: 1px solid #ddd;
}
</style>
</head>
<body style="padding-top: 50px;">
<div class="moveBar">
    <div id="banner">按住此處拖拽移動</div>
    <div class="content">這裡是彈出層內容區域</div>
</div>
<div class="footer"><p>版權所有</p></div>

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
$(function() {
    $('#banner').on('mousedown', function(e) {
        var $dialog = $('div.moveBar');
        var isMove = true;
        
        // 計算滑鼠相對對話框左上角的偏移
        var offsetX = e.pageX - $dialog.offset().left;
        var offsetY = e.pageY - $dialog.offset().top;
        
        // 綁定文檔級事件,防止滑鼠移出對話框丟失事件
        $(document).on('mousemove.drag', function(e) {
            if (!isMove) return;
            $dialog.css({
                left: e.pageX - offsetX,
                top: e.pageY - offsetY
            });
        }).on('mouseup.drag', function() {
            isMove = false;
            $(document).off('.drag'); // 清理事件
        });
        
        // 防止文字選中干擾
        e.preventDefault();
    });
});
</script>
</body>
</html>

關鍵技術細節

  • 事件委託給 document:滑鼠移動超過對話框邊界時,元素級 mousemove 會失效,文檔級事件全域捕獲。
  • 命名空間事件:.on('mousemove.drag') / .off('.drag') 精準清理,不影響其他監聽器。
  • e.preventDefault():阻止滑鼠按下時的默認文字選中行為。
  • user-select: none:CSS 禁止拖拽手柄內文字被選中。

進階功能擴展

1. 邊界限制(不超出視窗)

$(document).on('mousemove.drag', function(e) {
    if (!isMove) return;
    var left = e.pageX - offsetX;
    var top = e.pageY - offsetY;
    
    // 視窗邊界
    var maxLeft = $(window).width() - $dialog.outerWidth();
    var maxTop = $(window).height() - $dialog.outerHeight();
    
    left = Math.max(0, Math.min(left, maxLeft));
    top = Math.max(0, Math.min(top, maxTop));
    
    $dialog.css({left: left, top: top});
});

2. 模態遮罩層

// 顯示時
$('').appendTo('body').fadeIn();
.dialog.show().css({left: '50%', top: '50%', marginLeft: -125, marginTop: -150});

// 關閉時
$('.modal-overlay').fadeOut(function() { $(this).remove(); });
.dialog.hide();

3. 現代化:原生 Drag API / Pointer Events


// 原生 HTML5 Drag API (僅支援拖拽數據傳輸,不適合 UI 移動)
// 推薦 Pointer Events 統一處理滑鼠/觸控
dialog.addEventListener('pointerdown', e => {
    dialog.setPointerCapture(e.pointerId);
    // ... 類似邏輯
});
dialog.addEventListener('pointermove', e => { /* 移動 */ });
dialog.addEventListener('pointerup', e => { dialog.releasePointerCapture(e.pointerId); });

應用場景

  • 模態對話框、彈出面板拖拽重定位
  • 儀表盤組件自由布局
  • 圖片裁剪框、縮放手柄
  • 可視化編輯器節點拖拽
copyright © 萬盛學電腦網 all rights reserved