当前位置：首页 > VUE

vue可拖拽功能实现

2026-01-22 23:19:20VUE

Vue 拖拽功能实现方法

使用 HTML5 原生拖拽 API

HTML5 提供了原生拖拽 API，可以通过 draggable 属性、dragstart、dragend、dragover 和 drop 事件实现基础拖拽功能。

<template>
  <div>
    <div 
      draggable="true"
      @dragstart="handleDragStart"
      @dragend="handleDragEnd"
    >可拖拽元素</div>

    <div 
      @dragover.prevent
      @drop="handleDrop"
    >放置区域</div>
  </div>
</template>

<script>
export default {
  methods: {
    handleDragStart(e) {
      e.dataTransfer.setData('text/plain', '拖拽数据')
    },
    handleDrop(e) {
      const data = e.dataTransfer.getData('text/plain')
      console.log('接收到的数据:', data)
    },
    handleDragEnd() {
      console.log('拖拽结束')
    }
  }
}
</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: '项目1' },
        { id: 2, name: '项目2' }
      ]
    }
  },
  methods: {
    onDragEnd() {
      console.log('排序后的列表:', this.list)
    }
  }
}
</script>

自定义拖拽实现

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

<template>
  <div>
    <div 
      class="draggable-item"
      @mousedown="startDrag"
      :style="itemStyle"
    >自定义拖拽元素</div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      isDragging: false,
      position: { x: 0, y: 0 },
      startPos: { x: 0, y: 0 }
    }
  },
  computed: {
    itemStyle() {
      return {
        transform: `translate(${this.position.x}px, ${this.position.y}px)`,
        cursor: this.isDragging ? 'grabbing' : 'grab'
      }
    }
  },
  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) return
      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>

<style>
.draggable-item {
  position: absolute;
  user-select: none;
}
</style>

拖拽与动画结合

使用 Vue 的过渡系统可以为拖拽操作添加平滑的动画效果。

<template>
  <draggable v-model="items" tag="transition-group" name="list">
    <div v-for="item in items" :key="item.id" class="item">
      {{ item.text }}
    </div>
  </draggable>
</template>

<style>
.list-move {
  transition: transform 0.3s ease;
}
.item {
  margin: 5px;
  padding: 10px;
  background: #f0f0f0;
}
</style>

跨组件拖拽实现

通过 Vue 的事件总线或状态管理实现跨组件拖拽数据传递。

// event-bus.js
import Vue from 'vue'
export const EventBus = new Vue()

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

// 组件B (放置目标)
created() {
  EventBus.$on('drag-start', data => {
    this.receivedData = data
  })
}

以上方法可根据具体需求选择使用，HTML5 原生 API 适合简单场景，Vue.Draggable 提供开箱即用的列表排序功能，自定义实现则适用于需要高度定制的拖拽交互。

vue可拖拽功能实现