useDraggableList 是一个基于 Vue Composition API 封装的拖拽排序自定义 Hook,接收含唯一 id 的列表,通过 ref 管理状态,暴露 onDragStart/onDragOver/onDrop 事件处理器,基于原生拖拽事件实现安全数组交换与响应式更新。

Vue Composition API 实现拖拽排序的组合式封装,核心是把拖拽逻辑从模板中抽离出来,封装成可复用、可测试、带响应式状态管理的自定义 Hook。它不依赖全局指令或第三方组件,而是围绕 ref、事件监听和数组操作构建清晰的数据流。
封装一个 useDraggableList 组合函数
这个 Hook 负责管理列表数据、拖拽索引、拖放位置计算和顺序更新,返回响应式列表和绑定方法:
- 接收初始列表数据(必须含唯一
id字段) - 内部用
ref管理items和draggedIndex - 暴露
onDragStart、onDragOver、onDrop三个事件处理器 - 所有操作都基于原生 HTML5 拖拽事件,无需额外依赖
关键逻辑:如何安全交换数组项
拖拽排序的本质是“取出一项,插入到新位置”。注意两个细节:
- 拖拽源索引可能大于或小于目标索引,直接
splice容易错位,推荐先移除再插入,并动态校正目标位置 - 若目标索引 ≥ 拖拽源索引,插入前需减 1(因为移除后后续项前移)
- 示例逻辑:
const movedItem = items.value.splice(draggedIndex.value, 1)[0]
const insertIndex = targetIndex > draggedIndex.value ? targetIndex - 1 : targetIndex
items.value.splice(insertIndex, 0, movedItem)
模板中怎么用:简洁绑定 + 语义化结构
在组件中调用 Hook 后,只需将事件绑定到 DOM 元素上,保持模板干净:
-
@dragover.prevent是必须的,否则drop不会触发 - 不需要手动写
dataTransfer,Vue 响应式已接管数据同步
进阶增强:支持跨列表拖拽与防抖更新
实际项目中常需扩展能力:
- 增加
groupId参数,在多个列表间共享拖拽组(配合event.dataTransfer.setData('text/group', groupId)) - 对
onDrop加防抖(尤其表格行数多时),避免高频触发导致视图抖动 - 导出
resetDragState方法,便于外部主动清理拖拽态(如取消编辑时) - 可选:集成
Sortable.js的底层能力,通过onMounted初始化实例,获得更好的触摸支持和动画效果
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










