vue实现拖拽组件
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 的响应式特性,可以轻松实现拖拽排序功能。
<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>
注意事项
- 拖拽事件需要阻止默认行为(如
@dragover.prevent)。 - 使用第三方库(如 Vue.Draggable)时,注意版本兼容性。
- 自定义拖拽实现时,确保及时移除事件监听器以避免内存泄漏。
以上方法可以根据实际需求选择适合的方式实现拖拽功能。






