vue实现元素拖拽事件
实现拖拽的基本步骤
在Vue中实现元素拖拽功能,可以通过HTML5的Drag and Drop API或第三方库如vuedraggable来完成。以下是两种常见方法的详细说明:
使用HTML5原生API
HTML5提供了原生的拖拽事件,适用于简单的拖拽需求。需要监听dragstart、dragover和drop等事件。

<template>
<div
draggable="true"
@dragstart="handleDragStart"
@dragover.prevent="handleDragOver"
@drop="handleDrop"
>
拖拽元素
</div>
</template>
<script>
export default {
methods: {
handleDragStart(e) {
e.dataTransfer.setData('text/plain', e.target.id);
},
handleDragOver(e) {
e.preventDefault(); // 必须阻止默认行为以允许放置
},
handleDrop(e) {
e.preventDefault();
const data = e.dataTransfer.getData('text/plain');
const draggedElement = document.getElementById(data);
e.target.appendChild(draggedElement);
}
}
};
</script>
使用vuedraggable库
对于复杂的拖拽排序需求,推荐使用vuedraggable库。它基于Sortable.js,提供了更简单的API。
安装依赖:

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('拖拽结束后的顺序:', this.list);
}
}
};
</script>
自定义拖拽逻辑
如果需要完全自定义拖拽行为,可以通过监听鼠标事件(mousedown、mousemove、mouseup)实现。
<template>
<div
ref="draggableElement"
@mousedown="startDrag"
style="position: absolute;"
>
可拖拽元素
</div>
</template>
<script>
export default {
data() {
return {
isDragging: false,
startX: 0,
startY: 0
};
},
methods: {
startDrag(e) {
this.isDragging = true;
this.startX = e.clientX - this.$refs.draggableElement.offsetLeft;
this.startY = e.clientY - this.$refs.draggableElement.offsetTop;
document.addEventListener('mousemove', this.drag);
document.addEventListener('mouseup', this.stopDrag);
},
drag(e) {
if (!this.isDragging) return;
this.$refs.draggableElement.style.left = `${e.clientX - this.startX}px`;
this.$refs.draggableElement.style.top = `${e.clientY - this.startY}px`;
},
stopDrag() {
this.isDragging = false;
document.removeEventListener('mousemove', this.drag);
document.removeEventListener('mouseup', this.stopDrag);
}
}
};
</script>
注意事项
- 使用原生API时,确保在
dragover事件中调用preventDefault(),否则无法触发drop事件。 vuedraggable适用于列表排序,支持跨列表拖拽、动画等高级功能。- 自定义拖拽逻辑需要处理事件监听器的添加和移除,避免内存泄漏。
- 移动端适配可能需要额外处理
touch事件。






