当前位置：首页 > VUE

vue实现拖拽组件

2026-02-18 12:30:20VUE

Vue 实现拖拽组件的方法

使用 HTML5 原生拖拽 API

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

<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);
    },
    handleDrop(e) {
      const id = e.dataTransfer.getData('text/plain');
      const draggableElement = document.getElementById(id);
      e.target.appendChild(draggableElement);
    }
  }
}
</script>

使用第三方库 Vue.Draggable

Vue.Draggable 是一个基于 Sortable.js 的 Vue 拖拽组件库，提供了更简单的 API 和更丰富的功能。

安装 Vue.Draggable：

npm install vuedraggable

使用示例：

<template>
  <draggable v-model="list" @end="onEnd">
    <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: {
    onEnd() {
      console.log('拖拽结束');
    }
  }
};
</script>

自定义拖拽实现

如果需要更灵活的拖拽逻辑，可以通过监听鼠标事件（mousedown、mousemove、mouseup）实现自定义拖拽。

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

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

拖拽排序列表

结合 Vue 的响应式特性，可以轻松实现拖拽排序功能。

vue实现拖拽组件

<template>
  <div 
    v-for="(item, index) in items" 
    :key="item.id"
    draggable="true"
    @dragstart="dragStart(index)"
    @dragover.prevent
    @drop="drop(index)"
  >
    {{ item.text }}
  </div>
</template>

<script>
export default {
  data() {
    return {
      items: [
        { id: 1, text: 'Item 1' },
        { id: 2, text: 'Item 2' }
      ],
      draggedIndex: null
    };
  },
  methods: {
    dragStart(index) {
      this.draggedIndex = index;
    },
    drop(index) {
      const item = this.items.splice(this.draggedIndex, 1)[0];
      this.items.splice(index, 0, item);
    }
  }
};
</script>