Vue3 Dnd实战案例从简单拖拽到复杂排序组件的完整指南【免费下载链接】vue3-dndReact Dnd implementation in Vue Composition-api.项目地址: https://gitcode.com/gh_mirrors/vu/vue3-dndVue3 Dnd是基于Vue Composition API实现的React Dnd移植版本为Vue3应用提供强大且灵活的拖拽功能支持。本文将通过多个实战案例从基础拖拽到高级排序组件帮助你快速掌握Vue3 Dnd的核心用法与最佳实践。 快速开始安装与基础配置环境准备首先确保你的项目已使用Vue3通过以下命令安装Vue3 Dndnpm install vue3-dnd # 或使用yarn yarn add vue3-dnd基础结构每个Vue3 Dnd应用都需要DndProvider作为根容器建议在main.ts中全局配置import { createApp } from vue import { DndProvider } from vue3-dnd import App from ./App.vue createApp(App) .component(DndProvider, DndProvider) .mount(#app)在组件中使用时只需将拖拽区域包裹在DndProvider中即可template DndProvider !-- 拖拽相关组件 -- /DndProvider /template 核心概念理解拖拽三要素Vue3 Dnd基于三个核心概念构建它们共同构成了拖拽功能的基础1. 拖拽源 (Drag Source)使用useDrag钩子定义可拖拽元素示例代码位于src/hooks/useDrag/useDrag.ts。基础用法const { drag, isDragging } useDrag({ type: BOX, // 拖拽类型字符串或Symbol item: () ({ id: box-1 }), // 拖拽数据 collect: (monitor) ({ isDragging: monitor.isDragging() }) })2. 放置目标 (Drop Target)使用useDrop钩子定义可接收拖拽元素的区域实现代码可见src/hooks/useDrop/useDrop.tsconst { drop } useDrop({ accept: BOX, // 接受的拖拽类型 drop: (item) { console.log(放置了:, item) }, collect: (monitor) ({ isOver: monitor.isOver() }) })3. 拖拽层 (Drag Layer)通过useDragLayer钩子创建自定义拖拽预览绕过浏览器默认样式限制详细实现见src/hooks/useDragLayer.ts。 实战案例一简单垃圾桶拖拽功能描述实现可拖拽的盒子元素将其拖入垃圾桶区域后删除基础示例代码位于packages/docs/src/example/dustbin/single-target.md。实现步骤定义拖拽类型创建ItemTypes.ts定义拖拽类型常量// src/components/single-target/ItemTypes.ts export const ItemTypes { BOX: box }创建可拖拽盒子组件使用useDrag钩子使元素可拖拽!-- src/components/single-target/Box.vue -- template div refdragRef :style{ opacity: isDragging ? 0.5 : 1, cursor: move } 可拖拽盒子 /div /template script setup langts import { useDrag } from vue3-dnd import { ItemTypes } from ./ItemTypes const props defineProps{ id: string }() const dragRef refHTMLElement | null(null) const { drag, isDragging } useDrag({ type: ItemTypes.BOX, item: () ({ id: props.id }), collect: (monitor) ({ isDragging: monitor.isDragging() }) }) drag(dragRef) /script创建垃圾桶组件使用useDrop钩子接收拖拽元素!-- src/components/single-target/Dustbin.vue -- template div refdropRef :style{ border: isOver ? 2px dashed red : 2px solid #ccc, minHeight: 100px, padding: 10px } 垃圾桶 {{ isOver ? 准备接收 : 等待拖拽 }} /div /template script setup langts import { useDrop } from vue3-dnd import { ItemTypes } from ./ItemTypes const emit defineEmits{ (e: delete, id: string): void }() const dropRef refHTMLElement | null(null) const { drop, isOver } useDrop({ accept: ItemTypes.BOX, drop: (item) { emit(delete, item.id) }, collect: (monitor) ({ isOver: monitor.isOver() }) }) drop(dropRef) /script组合使用组件在容器中管理盒子状态!-- src/components/single-target/Container.vue -- template div div classboxes Box v-forbox in boxes :keybox.id :idbox.id / /div Dustbin deletehandleDelete / /div /template script setup langts import { ref } from vue import Box from ./Box.vue import Dustbin from ./Dustbin.vue const boxes ref([ { id: box-1 }, { id: box-2 }, { id: box-3 } ]) const handleDelete (id: string) { boxes.value boxes.value.filter(box box.id ! id) } /script 实战案例二实现可排序列表功能描述创建支持拖拽排序的列表组件用户可通过拖拽调整项目顺序完整示例参考packages/docs/src/example/sortable/simple.md。实现要点使用拖拽源与放置目标组合每个列表项既是拖拽源也是放置目标位置交换逻辑在放置时计算新位置并更新列表顺序// 核心排序逻辑 const handleDrop (draggedId: string, targetId: string) { const draggedIndex items.value.findIndex(item item.id draggedId) const targetIndex items.value.findIndex(item item.id targetId) // 创建新数组避免直接修改原数组 const newItems [...items.value] // 移除拖动项 const [draggedItem] newItems.splice(draggedIndex, 1) // 插入到目标位置 newItems.splice(targetIndex, 0, draggedItem) items.value newItems }拖拽指示器添加视觉提示指示放置位置增强用户体验!-- 拖拽指示器组件 -- template div v-ifisDragging classdrag-indicator :style{ top: ${position}px } / /template 高级特性与最佳实践自定义拖拽预览默认情况下浏览器会创建元素截图作为拖拽预览。通过dragPreview连接器可自定义预览内容const { drag, dragPreview } useDrag({ // ...其他配置 }) // 使用单独的元素作为拖拽预览 drag(dragSourceRef) dragPreview(previewRef)更高级的自定义预览可使用DragPreviewImage组件或自定义拖拽层详见src/guide/components/drag-preview-image.md。拖拽手柄有时我们希望只有元素的特定部分可触发拖拽可通过拖拽手柄实现template div classitem div refdragHandle classdrag-handle☰/div div classcontent{{ item.content }}/div /div /template script setup langts const dragHandle refHTMLElement | null(null) const { drag } useDrag({ /* ... */ }) // 只将手柄设为拖拽源 drag(dragHandle) /script完整示例可参考自定义拖动手柄示例。性能优化对于大量元素的拖拽场景如100项的排序列表建议使用memo缓存collect函数返回值对拖拽源使用arePropsEqual优化重渲染考虑虚拟滚动列表仅渲染可见项性能测试示例可见packages/docs/src/example/sortable/stress-test.md。 学习资源与文档官方文档项目提供了完整的API文档和使用指南位于packages/docs/src/guide/示例代码所有示例的源代码可在packages/docs/src/.vitepress/examples目录找到核心APIuseDragsrc/hooks/useDrag/useDrag.tsuseDropsrc/hooks/useDrop/useDrop.tsuseDragLayersrc/hooks/useDragLayer.ts 从Vue2迁移如果你的项目正在从Vue2迁移到Vue3可参考Vue2迁移指南其中详细说明了Vue3 Dnd与vue-dnd2的差异及迁移步骤。 结语Vue3 Dnd通过Composition API提供了灵活且强大的拖拽功能从简单的元素拖拽到复杂的排序组件都能轻松应对。掌握本文介绍的核心概念和实战案例后你可以开始在项目中实现各种拖拽交互功能。记得查看项目中的完整示例和API文档以便更深入地了解Vue3 Dnd的全部功能。祝你在Vue3拖拽开发之路上一帆风顺【免费下载链接】vue3-dndReact Dnd implementation in Vue Composition-api.项目地址: https://gitcode.com/gh_mirrors/vu/vue3-dnd创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
企业数字化 ERP 产品动态
相关推荐
如何用PyOfficeRobot收集群消息?数据提取与分析实战 如何用PyOfficeRobot收集群消息?数据提取与分析实战 【免费下载链接】PyOfficeRobot pip install PyOfficeRobot,微信机器人 项目地址: https://gitcode.com/gh_mirrors/py/PyOfficeRobot
PyOfficeRobot是一款强大的微信机器人工具,通… · 2026/11/16 14:06:15
pxpipe长文本处理:通过图像编码降低AI应用Token成本70% 在实际 AI 应用开发中,处理长文本上下文一直是成本控制的痛点。无论是技术文档分析、日志解析还是多轮对话场景,传统的大语言模型按 Token 计费模式往往让开发者面对动辄数千甚至数万的 Token 消耗。尤其当文本包含大量代码、缩进、重复结构或特殊字符时… · 2026/9/17 15:24:30
设计公司如何利用AI工作流提升效率与创意 1. 为什么设计服务公司天然适配AI工作流在设计行业摸爬滚打十几年,我发现一个有趣的现象:最近两年转型最成功的设计公司,往往都是最早把AI工具链融入工作流程的那批。这不仅仅是工具迭代的问题,而是设计服务的业务特性与AI工作流存… · 2026/11/11 6:32:03
电工证属于全国通用吗 在哪考才不会被坑 电工证属于全国通用吗 在哪考才不会被坑 不知道去哪报名怕被中介坑?你不是一个人。特别是像你这样在洛阳负责中小型施工项目的老板,手里握着一堆工程,最怕的就是人手不够、证件不全,一旦出事,责任全在你头上。现在问题来了——… · 2026/11/16 14:05:44
电工作业危害分柝通过率揭秘:工地太忙根本没时间复习考试? 电工作业危害分柝通过率揭秘:工地太忙根本没时间复习考试? 工地太忙根本没时间复习考试,这几乎是每个电工都面临的现实问题。尤其是郑州金水区的劳务班组负责人,既要盯紧工程进度,又要确保工人持证上岗,压力山大。电工作业危害分柝,看似是考试内容,实… · 2026/11/16 14:05:44
亳州电工证考证哪家好 内部消息告诉你怎么避坑 亳州电工证考证哪家好 内部消息告诉你怎么避坑 你是不是也正为【亳州电工证考证哪家好】这个问题发愁?到处打听,却总觉得被中介绕晕,担心花了钱还拿不到证?别急,我在这行干了这么多年,知道哪些机构靠谱,哪些是“ 挂羊头卖狗肉… · 2026/11/16 14:05:44
同安哪里能培训电工证 上岗必备的电工证怎么考? 同安哪里能培训电工证 上岗必备的电工证怎么考? 找工作难,但没有电工证更难!很多想进工地、工厂、电力维修岗位的小伙伴都卡在了“ 上岗必备… · 2026/11/16 14:05:44
森宇特种工咨询怎么考上岗必备的证 森宇特种工咨询怎么考上岗必备的证 你是不是也正为找工作发愁?急需特种作业证才能上岗找工作,这事儿真的刻不容缓。特种作业证是很多岗位的 上岗必备… · 2026/11/16 14:05:44
电工证补考期限多久?工地太忙根本没时间复习考试 电工证补考期限多久?工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,这几乎是所有在一线从事电工工作的朋友们的真实写照。尤其是对于需要持证上岗的特种作业人员来说, 电工证的含金量… · 2026/11/16 14:04:43
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/16 3:21:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/16 3:01:18
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/16 8:30:17
电工证培训的通知在哪考?别再被中介骗了 电工证培训的通知在哪考?别再被中介骗了 你是不是还在为 电工证培训的通知在哪考 发愁?网上搜了一堆信息,结果要么是挂羊头卖狗肉的培训机构,要么就是打着“包过”旗号的骗子?别急,今天我来给你讲讲, 电工证培训的通知… · 2026/11/16 0:00:34
电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 怕考不过白交培训费?你不是一个人,信阳的李师傅去年刚转岗做电工,就因为没搞清楚电工证去哪个部门考核,差点交了8000块的培训费。别急,下面这份实操考试全攻略,告诉你电工证到底值不值得考… · 2026/11/16 0:00:34
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 1:51:20
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 4:02:19
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 3:02:05