`
vuedraggable` 是一个基于
Vue.js 的可拖拽列表组件，可以用于实现拖拽排序、拖拽添加、拖拽删除等功能。它支持多种方式的拖拽，如鼠标拖拽、触摸拖拽等。
以下是 `
vuedraggable` 的使用文档：
### 安装
使用 npm 或 yarn 安装 `
vuedraggable`：
```bash
npm install
vuedraggable --save
# 或
yarn add
vuedraggable
```
### 引入
在需要使用 `
vuedraggable` 的组件中引入：
```javascript
import
draggable from '
vuedraggable'
```
### 基本使用
在组件中使用 `
draggable` 标签，并绑定需要拖拽的数据：
```html
<
draggable v-model="list">
<div v-for="item in list" :key="item.id">{{ item.content }}</div>
</
draggable>
```
其中，`list` 是一个数组，用于存储需要拖拽的数据。在 `
draggable` 组件中，使用 `v-model` 绑定这个数组，即可实现数据的拖拽排序。
### 属性
`
vuedraggable` 支持多种属性，用于控制拖拽的行为和样式。
- `value`：绑定拖拽的数据数组，可以使用 `v-model` 代替。
- `group`：设置拖拽分组，同一组内的元素可以互相拖拽。可以是字符串类型或对象类型，对象类型的值支持以下属性：
- `name`：分组名称。
- `put`：是否允许拖拽放置到该分组内的元素中，默认为 `true`。
- `pull`：是否允许从该分组内的元素中拖拽出来，默认为 `true`。
- `handle`：设置拖拽把手的 CSS 选择器，只有在把手内拖拽才有效。
- `disabled`：禁用拖拽功能，可以是布尔类型或返回布尔类型的函数。
- `
clone`：是否复制元素，而不是移动元素。可以是布尔类型或返回布尔类型的函数。
- `move`：自定义拖拽元素的移动方式，可以是函数或对象。函数接收 3 个参数：
- `evt`：拖拽事件对象。
- `originalEvent`：原始事件对象。
- `element`：拖拽元素。
对象类型的值支持以下属性：
- `start`：拖拽开始时的回调函数，接收 2 个参数：`evt` 和 `element`。
- `drag`：拖拽进行中的回调函数，接收 3 个参数：`evt`、`originalEvent` 和 `element`。
- `end`：拖拽结束时的回调函数，接收 2 个参数：`evt` 和 `element`。
- `onMove`：自定义移动方式的函数，接收 2 个参数：`evt` 和 `element`，返回 `true` 表示允许移动，返回 `false` 表示禁止移动。
- `tag`：设置拖拽容器的 HTML 标签，默认为 `div`。
- `list`：绑定拖拽的数据数组，可以使用 `v-model` 代替。
- `componentData`：传递给拖拽元素的额外数据。可以是对象类型或返回对象类型的函数。
- `moveTransition`：设置拖拽元素的过渡动画，可以是字符串类型或对象类型。对象类型的值支持以下属性：
- `css`：设置 CSS 过渡属性，默认为 `true`。
- `duration`：设置过渡动画的时长，单位为毫秒，默认为 `200`。
- `curtain`：设置拖拽元素的幕布，即在拖拽过程中的半透明遮罩层。可以是字符串类型或对象类型。对象类型的值支持以下属性：
- `zIndex`：设置幕布的层级，默认为 `9999`。
- `opacity`：设置幕布的不透明度，默认为 `0.5`。
- `bgColor`：设置幕布的背景颜色，默认为 `#fff`。
### 事件
`
vuedraggable` 支持多种事件，用于在拖拽过程中执行自定义操作。
- `start`：拖拽开始时的回调函数，接收 2 个参数：`evt` 和 `element`。
- `add`：元素被添加到容器时的回调函数，接收 2 个参数：`evt` 和 `element`。
- `remove`：元素从容器中删除时的回调函数，接收 2 个参数：`evt` 和 `element`。
- `update`：拖拽元素位置发生变化时的回调函数，接收 4 个参数：`evt`、`originalEvent`、`oldIndex` 和 `newIndex`。
- `end`：拖拽结束时的回调函数，接收 2 个参数：`evt` 和 `element`。
### 示例
以下是一个完整的 `
vuedraggable` 示例：
```html
<template>
<div>
<
draggable v-model="list" group="fruits" handle=".handle" @add="onAdd">
<div v-for="(item, index) in list" :key="item.id" class="item">
<span class="handle">↕</span>
{{ item.content }}
<button @click="removeItem(index)">删除</button>
</div>
</
draggable>
<
draggable v-model="fruits" group="fruits">
<div v-for="fruit in fruits" :key="fruit" class="fruit">{{ fruit }}</div>
</
draggable>
</div>
</template>
<script>
import
draggable from '
vuedraggable'
export default {
components: {
draggable
},
data() {
return {
list: [
{ id: 1, content: '苹果' },
{ id: 2, content: '香蕉' },
{ id: 3, content: '橘子' },
{ id: 4, content: '西瓜' }
],
fruits: ['苹果', '香蕉', '橘子', '西瓜', '葡萄']
}
},
methods: {
removeItem(index) {
this.list.splice(index, 1)
},
onAdd(evt) {
console.log('添加了元素：', evt.item)
}
}
}
</script>
<style scoped>
.item {
display: flex;
align-items: center;
padding: 10px;
margin: 5px;
border: 1px solid #ccc;
border-radius: 5px;
}
.handle {
margin-right: 10px;
cursor: pointer;
}
.fruit {
display: inline-block;
padding: 5px 10px;
margin: 5px;
background-color: #eee;
border: 1px solid #ccc;
border-radius: 5px;
}
</style>
```
以上示例实现了一个拖拽列表，可以对列表项进行排序和删除。同时，还提供了一个可拖拽的水果列表，可以将水果添加到列表中。
最低0.47元/天 解锁文章
263
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
