Vue实现高效拖拽效果 vue-Draggable

Vue.Draggable是基于Sortable.js的Vue组件,提供直观的拖拽排序功能,支持列表项拖拽、跨列表拖拽、动画效果等特性

安装

npm install vuedraggable

组件引用

javascript 复制代码
import draggable from 'vuedraggable'

export default {
    components: {
        draggable
    }
}

1.基础拖拽排序

javascript 复制代码
<template>
  <draggable v-model="list">
    <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' },
      ]
    };
  }
};
</script>

2.跨列表拖拽

javascript 复制代码
<template>
  <div class="container">
    <draggable v-model="listA" group="shared">
      <div v-for="item in listA" :key="item.id">{{ item.name }}</div>
    </draggable>
    <draggable v-model="listB" group="shared">
      <div v-for="item in listB" :key="item.id">{{ item.name }}</div>
    </draggable>
  </div>
</template>
<script>
export default {
  data() {
    return {
      listA: [{ id: 1, name: 'A1' }],
      listB: [{ id: 2, name: 'B1' }]
    };
  }
};
</script>
<style>
.container { display: flex; justify-content: space-around; }
</style>

核心参数配置

常用参数

|------------|---------------|----------------|-------------------------------------------------------|
| 参数名 | 类型 | 默认值 | 说明 |
| v-model | Array | - | 绑定数据源,拖拽后自动更新 |
| group | String/Object | - | 跨列表拖拽组名,如{ name: 'shared', pull: 'clone', put: false} |
| animation | Number | 0 | 拖拽动画时长(毫秒) |
| ghostClass | String | sortable-ghost | 拖拽占位元素样式类 |
| sort | Blooean | false | 是否允许排序 |
| disabled | Blooean | fasle | 是否禁用拖拽功能 |
| handle | | | 指定拖动手柄的CSS选择器,只有点击该元素才能拖动列表项 |
| filter | | | 指定不允许拖动的元素CSS选择器 |

事件系统

|-------|-------------------------|------------|
| 事件名 | 回调参数 | 说明 |
| start | {to,from,item,oldIndex} | 拖拽开始时触发 |
| end | {to,from,newIndex} | 拖拽结束时触发 |
| add | {to,item,newIndex} | 元素添加到列表时触发 |

3.条件拖拽

javascript 复制代码
<template>
  <draggable v-model="list" :move="checkMove">
    <div v-for="item in list" :key="item.id">{{ item.name }}</div>
  </draggable>
</template>
<script>
export default {
  data() {
    return {
      list: [
        { id: 1, name: 'Allowed', allowed: true },
        { id: 2, name: 'Blocked', allowed: false }
      ]
    };
  },
  methods: {
    checkMove(evt) {
      return evt.draggedContext.element.allowed;
    }
  }
};
</script>

4.嵌套拖拽

javascript 复制代码
<template>
  <draggable v-model="treeData" group="tree">
    <div v-for="node in treeData" :key="node.id">
      {{ node.name }}
      <draggable v-if="node.children" v-model="node.children" group="tree">
        <div v-for="child in node.children" :key="child.id">{{ child.name }}</div>
      </draggable>
    </div>
  </draggable>
</template>
<script>
export default {
  data() {
    return {
      treeData: [
        {
          id: 1,
          name: 'Parent',
          children: [
            { id: 2, name: 'Child 1' },
            { id: 3, name: 'Child 2' }
          ]
        }
      ]
    };
  }
};
</script>

注意事项

1.唯一key:确保列表使用唯一标识作为key,避免索引作为key导致的渲染问题

2.性能优化:大数据列表禁用动画(no-transition-on-drag)或使用virtual-scroll

3.样式冲突:若自定义样式不生效,使用::v-deep穿透作用域CSS

相关推荐
Mh12 小时前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳13 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔13 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart14 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt15 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑15 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星16 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson16 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼17 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊17 小时前
CNC计算机数控加工模拟器
前端