当前位置：首页 > VUE

vue实现组件拖拽

2026-02-20 08:47:58VUE

Vue 实现组件拖拽的方法

使用 HTML5 原生拖拽 API

HTML5 提供了原生拖拽 API，可以通过 draggable 属性和相关事件实现拖拽功能。

<template>
  <div
    draggable="true"
    @dragstart="handleDragStart"
    @dragend="handleDragEnd"
    @dragover.prevent
    @drop="handleDrop"
  >
    拖拽元素
  </div>
</template>

<script>
export default {
  methods: {
    handleDragStart(e) {
      e.dataTransfer.setData('text/plain', e.target.id);
    },
    handleDragEnd(e) {
      // 拖拽结束处理
    },
    handleDrop(e) {
      e.preventDefault();
      const data = e.dataTransfer.getData('text/plain');
      const draggedElement = document.getElementById(data);
      e.target.appendChild(draggedElement);
    }
  }
};
</script>

使用第三方库 Vue.Draggable

Vue.Draggable 是一个基于 Sortable.js 的 Vue 拖拽组件库，适合列表排序和复杂拖拽场景。

安装：

npm install vuedraggable

使用示例：

<template>
  <draggable v-model="list" @end="onDragEnd">
    <div v-for="item in list" :key="item.id">
      {{ item.name }}
    </div>
  </draggable>
</template>

<script>
import draggable from 'vuedraggable';

export default {
  components: { draggable },
  data() {
    return {
      list: [
        { id: 1, name: 'Item 1' },
        { id: 2, name: 'Item 2' }
      ]
    };
  },
  methods: {
    onDragEnd() {
      console.log('拖拽完成');
    }
  }
};
</script>

使用自定义拖拽逻辑

对于更复杂的拖拽需求，可以结合鼠标事件实现自定义拖拽逻辑。

<template>
  <div
    ref="dragElement"
    @mousedown="startDrag"
    @mousemove="onDrag"
    @mouseup="stopDrag"
    :style="dragStyle"
  >
    自定义拖拽元素
  </div>
</template>

<script>
export default {
  data() {
    return {
      isDragging: false,
      startX: 0,
      startY: 0,
      offsetX: 0,
      offsetY: 0
    };
  },
  computed: {
    dragStyle() {
      return {
        position: 'absolute',
        left: `${this.offsetX}px`,
        top: `${this.offsetY}px`,
        cursor: this.isDragging ? 'grabbing' : 'grab'
      };
    }
  },
  methods: {
    startDrag(e) {
      this.isDragging = true;
      this.startX = e.clientX;
      this.startY = e.clientY;
    },
    onDrag(e) {
      if (!this.isDragging) return;
      this.offsetX = e.clientX - this.startX;
      this.offsetY = e.clientY - this.startY;
    },
    stopDrag() {
      this.isDragging = false;
    }
  }
};
</script>

拖拽边界限制

为了防止元素被拖出可视区域，可以添加边界检查逻辑。

onDrag(e) {
  if (!this.isDragging) return;

  const newX = e.clientX - this.startX;
  const newY = e.clientY - this.startY;

  const maxX = window.innerWidth - this.$refs.dragElement.offsetWidth;
  const maxY = window.innerHeight - this.$refs.dragElement.offsetHeight;

  this.offsetX = Math.max(0, Math.min(newX, maxX));
  this.offsetY = Math.max(0, Math.min(newY, maxY));
}

拖拽放置区域高亮

在拖拽过程中高亮可能的放置区域，提升用户体验。

<template>
  <div
    @dragover="highlightDropZone"
    @dragleave="unhighlightDropZone"
    @drop="handleDrop"
    :class="{ 'highlight': isHighlighted }"
  >
    放置区域
  </div>
</template>

<script>
export default {
  data() {
    return {
      isHighlighted: false
    };
  },
  methods: {
    highlightDropZone() {
      this.isHighlighted = true;
    },
    unhighlightDropZone() {
      this.isHighlighted = false;
    }
  }
};
</script>

<style>
.highlight {
  border: 2px dashed #42b983;
  background-color: rgba(66, 185, 131, 0.1);
}
</style>

vue实现组件拖拽