当前位置：首页 > VUE

vue如何实现元素拖拽

2026-01-21 12:02:22VUE

实现元素拖拽的基本方法

在Vue中实现元素拖拽通常可以通过HTML5的Drag and Drop API或第三方库（如vuedraggable）来完成。以下是两种常见的方法：

使用HTML5 Drag and Drop API

HTML5原生提供了拖放功能，通过draggable属性、dragstart、dragend、dragover和drop等事件实现。

<template>
  <div 
    class="draggable-item" 
    draggable="true"
    @dragstart="handleDragStart"
    @dragend="handleDragEnd"
  >
    拖拽我
  </div>
  <div 
    class="drop-zone" 
    @dragover.prevent
    @drop="handleDrop"
  >
    放置区域
  </div>
</template>

<script>
export default {
  methods: {
    handleDragStart(e) {
      e.dataTransfer.setData('text/plain', '拖拽数据');
    },
    handleDragEnd() {
      console.log('拖拽结束');
    },
    handleDrop(e) {
      const data = e.dataTransfer.getData('text/plain');
      console.log('放置数据:', data);
    }
  }
};
</script>

关键点

设置draggable="true"使元素可拖拽。
@dragover.prevent阻止默认行为以允许放置。
dataTransfer用于传递拖拽数据。

使用vuedraggable库

vuedraggable是基于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: '项目A' },
        { id: 2, name: '项目B' }
      ]
    };
  },
  methods: {
    onDragEnd() {
      console.log('拖拽后的列表:', this.list);
    }
  }
};
</script>

功能特点

直接绑定数组，拖拽后自动更新数据。
支持动画、跨列表拖拽等高级功能。

自定义拖拽逻辑

对于更复杂的拖拽需求（如限制拖拽范围、自定义拖拽样式），可以结合鼠标事件（mousedown、mousemove、mouseup）实现。

<template>
  <div 
    class="custom-draggable" 
    @mousedown="startDrag"
    :style="{ left: position.x + 'px', top: position.y + 'px' }"
  >
    自定义拖拽元素
  </div>
</template>

<script>
export default {
  data() {
    return {
      position: { x: 0, y: 0 },
      isDragging: false,
      startPos: { x: 0, y: 0 }
    };
  },
  methods: {
    startDrag(e) {
      this.isDragging = true;
      this.startPos = { x: e.clientX - this.position.x, y: e.clientY - this.position.y };
      document.addEventListener('mousemove', this.onDrag);
      document.addEventListener('mouseup', this.stopDrag);
    },
    onDrag(e) {
      if (this.isDragging) {
        this.position = {
          x: e.clientX - this.startPos.x,
          y: e.clientY - this.startPos.y
        };
      }
    },
    stopDrag() {
      this.isDragging = false;
      document.removeEventListener('mousemove', this.onDrag);
      document.removeEventListener('mouseup', this.stopDrag);
    }
  }
};
</script>

注意事项

通过计算鼠标偏移量实现平滑拖拽。
及时移除事件监听避免内存泄漏。

跨组件拖拽

若需跨组件传递拖拽数据，可以使用Vue的event bus或状态管理（如Vuex）。

// eventBus.js
import Vue from 'vue';
export const EventBus = new Vue();

// 组件A（拖拽源）
methods: {
  handleDragStart() {
    EventBus.$emit('drag-start', { data: 'some data' });
  }
}

// 组件B（放置目标）
created() {
  EventBus.$on('drag-start', (data) => {
    console.log('接收数据:', data);
  });
}

适用场景