最近在学习一个可视化搭建的项目,里面用的拖拽就是draggable.js。看了几个中文的文档,有很多坑,可能是没有及时更新的原因。
VUe
建议去看vuedraggable的官方文档,只不过是英文的。官方文档:https://github.com/SortableJS/Vue.Draggable;
由于vue3已经是默认版本了,所以vuedraggable也对应vue2.0和3.0有各自的版本,直接使用基本命令安装:
npm install vuedraggable --save
会默认安装2.1左右的版本,由于我的项目是vue3构建的,所以会报错:
就是draggable版本不对,导致错误,版本换位4.1.0的就解决了
npm i vuedraggable@4.1.0 --save 或 yarn add vuedraggable@4.1.0
在官网里专门对vue版本的不同做了对应的解释,在vue2中,
<draggable v-model="myArray" group="people" @start="drag=true" @end="drag=false">
<div v-for="element in myArray" :key="element.id">{{element.name}}</div>
</draggable>
//.vue file:
import draggable from 'vuedraggable'
...
export default {
components: {
draggable,
},
...
With transition-group
:
<draggable v-model="myArray">
<transition-group>
<div v-for="element in myArray" :key="element.id">
{{element.name}}
</div>
</transition-group>
</draggable>
而在vue3中,这样写是有问题的,官网提示:
Breaking changes:
- Use
item
slot instead of default to display elements#使用项目槽而不是默认值来显示元素- Provide a key for items using
itemKey
props#使用itemKey道具为物品提供密钥
变动确实挺大的,写法如下:
From:
<!-- vue 2 version -->
<draggable v-model="myArray">
<div v-for="element in myArray" :key="element.id">{{element.name}}</div>
</draggable>
To:
<draggable v-model="myArray" item-key="id">
<template #item="{element}">
<div>{{element.name}}</div>
</template>
</draggable>
当使用transition时,现在应该使用tag和componentData来创建transition
From
<!-- vue 2 version -->
<draggable v-model="myArray">
<transition-group name="fade">
<div v-for="element in myArray" :key="element.id">
{{element.name}}
</div>
</transition-group>
</draggable>
to
<draggable v-model="myArray" tag="transition-group" :component-data="{name:'fade'}">
<template #item="{element}">
<div>{{element.name}}</div>
</template>
</draggable>
注:在进行clone时,vue2.x版本Draggable 组件中的配置项写法(:options="{group:{name: 'article',pull:'clone'}, sort: false}")在vue3中不起效,
vue3中需要将里面的参数单独进行配置,如::group="{name: 'article',pull:'clone'}" :sort='false' 等。