萬盛學電腦網

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

JavaScript 實現元素拖拽移動的完整實戰代碼(含邊界檢測、圖片拖拽修復)

設計思路

  1. 在拖拽手柄(如標題欄)綁定 mousedown。
  2. 在 document 上綁定 mousemove/mouseup,防止鼠標移出元素導致事件丟失。
  3. 移動時計算偏移量更新元素 left/top,並做邊界限制。
  4. 鬆開鼠標解除文檔級事件監聽。

關鍵細節處理

1. 防止文字被選中

e.preventDefault(); // Chrome/Firefox/IE9+
window.getSelection ? window.getSelection().removeAllRanges() : document.selection.empty(); // 兼容舊 IE

2. 防止圖片默認拖拽行為

e.preventDefault(); // 在 mousemove 中調用,阻止瀏覽器顯示「禁止」圖標

3. 邊界檢測優化寫法

// 錯誤寫法:直接判斷範圍會導致邊緣卡頓
if (x >= limit._left && x <= limit._right) { $target.css({left: x}); }

// 正確寫法:先計算再鉗制
if (x < limit._left) x = limit._left;
if (x > limit._right) x = limit._right;
// 或一行式
$target.css({
  left: Math.max(Math.min(x, limit._right), limit._left) + 'px',
  top:  Math.max(Math.min(y, limit._bottom), limit._top) + 'px'
});

完整 jQuery 插件封裝

$.fn.extend({
  drag: function(options) {
    var dragStart, dragMove, dragEnd, $boundaryElem, limitObj;

    function _initOptions() {
      var noop = function(){}, defaultOptions = { boundaryElem: 'body' };
      options = $.extend(defaultOptions, options || {});
      $boundaryElem = $(options.boundaryElem);
      dragStart = options.dragStart || noop;
      dragMove  = options.dragMove  || noop;
      dragEnd   = options.dragEnd   || noop;
    }

    function _drag(e) {
      var clientX = e.clientX, clientY = e.clientY;
      var $target = $(this), self = this;
      var offsetLeft = this.offsetLeft, offsetTop = this.offsetTop;

      limitObj = {
        _left: 0,
        _top: 0,
        _right: ($boundaryElem.innerWidth() || $(window).width()) - $target.outerWidth(),
        _bottom: ($boundaryElem.innerHeight() || $(window).height()) - $target.outerHeight()
      };

      dragStart.apply(self, arguments);

      $(document).bind('mousemove', moveHandle).bind('mouseup', upHandle);

      function moveHandle(e) {
        var x = e.clientX - clientX + offsetLeft;
        var y = e.clientY - clientY + offsetTop;
        $target.css({
          left: Math.max(Math.min(x, limitObj._right), limitObj._left) + 'px',
          top:  Math.max(Math.min(y, limitObj._bottom), limitObj._top) + 'px'
        });
        dragMove.apply(self, arguments);
        e.preventDefault(); // 阻止圖片默認拖拽
      }

      function upHandle(e) {
        $(document).unbind('mousemove', moveHandle).unbind('mouseup', upHandle);
        dragEnd.apply(self, arguments);
      }
    }

    _initOptions();
    return this.css({position: 'absolute'}).each(function() {
      $(this).bind('mousedown', function(e) {
        _drag.apply(this, [e]);
        e.preventDefault();
        window.getSelection ? window.getSelection().removeAllRanges() : document.selection.empty();
      });
    });
  }
});

使用示例

$('.drag-elem').drag({
  boundaryElem: '#boundary',
  dragStart: function() { console.log('開始拖拽'); },
  dragMove: function() { /* 實時回調 */ },
  dragEnd: function() { console.log('結束拖拽'); }
});

原生 JS 版本(無依賴)

同理可用 addEventListener 實現,邏輯完全一致,適合無 jQuery 環境。

總結

拖拽核心 = 事件委託到 document + 偏移量計算 + 邊界鉗制。掌握此模式,可擴展至調整大小、排序、畫布繪圖等交互。

copyright © 萬盛學電腦網 all rights reserved