vue实现拖拽事件
Vue 实现拖拽事件的方法
使用 HTML5 原生拖拽 API
HTML5 提供了原生的拖拽 API,可以通过 draggable 属性、dragstart、dragend、dragover 和 drop 等事件实现拖拽功能。
<template>
<div>
<div
draggable="true"
@dragstart="handleDragStart"
@dragend="handleDragEnd"
>
拖拽元素
</div>
<div
@dragover.prevent="handleDragOver"
@drop="handleDrop"
>
放置区域
</div>
</div>
</template>
<script>
export default {
methods: {
handleDragStart(e) {
e.dataTransfer.setData('text/plain', '拖拽数据');
},
handleDragOver(e) {
e.preventDefault();
},
handleDrop(e) {
e.preventDefault();
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>
<div>
<draggable
v-model="list"
@end="onDragEnd"
>
<div v-for="item in list" :key="item.id">
{{ item.name }}
</div>
</draggable>
</div>
</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>
自定义拖拽实现
通过鼠标事件(mousedown、mousemove、mouseup)实现更灵活的拖拽逻辑。
<template>
<div>
<div
ref="draggableElement"
@mousedown="startDrag"
:style="dragStyle"
>
自定义拖拽元素
</div>
</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;
document.addEventListener('mousemove', this.onDrag);
document.addEventListener('mouseup', this.stopDrag);
},
onDrag(e) {
if (this.isDragging) {
this.offsetX = e.clientX - this.startX;
this.offsetY = e.clientY - this.startY;
}
},
stopDrag() {
this.isDragging = false;
document.removeEventListener('mousemove', this.onDrag);
document.removeEventListener('mouseup', this.stopDrag);
}
}
};
</script>
注意事项
- 使用 HTML5 拖拽 API 时,需注意浏览器兼容性。
- 拖拽过程中可能需要阻止默认事件(如
e.preventDefault())。 - 第三方库(如 Vue.Draggable)适合复杂场景,但会增加项目体积。
- 自定义拖拽实现更灵活,但需处理更多细节(如边界限制)。






