Vue.Draggable是一款基於Sortable.js實現的vue拖拽插件。支持移動設備、拖拽和選擇文本、智能滾動,可以在不同列表間拖拽、不依賴jQuery為基礎、vue 2過渡動畫兼容、支持撤銷操作,總之是一款非常優秀的vue拖拽組件。本篇將介紹如何搭建環境及簡單的例子,使用起來特別簡單對被拖拽元素也沒有CSS樣式的特殊要求。
文檔地址:vuedraggable
NPM或yarn安裝方式
yarn add vuedraggable
npm i -S vuedraggable
| 屬性名稱 | 說明 |
|---|---|
| group | :group= "name",相同的組之間可以相互拖拽 |
| sort | :sort= "true",是否開啟內部排序,如果設置為false,它所在組無法排序,在其他組可以拖動排序 |
| delay | :delay= "0", 鼠標按下后多久可以拖拽 |
| touchStartThreshold | 鼠標移動多少px才能拖動元素 |
| disabled | :disabled= "true",是否啟用拖拽組件 |
| animation | 拖動時的動畫效果,還是很酷的,數字類型。如設置animation=1000表示1秒過渡動畫效果 |
| handle | :handle=".mover" 只有當鼠標移動到css為mover類的元素上才能拖動 |
| filter | :filter=".unmover" 設置了unmover樣式的元素不允許拖動 |
| draggable | :draggable=".item" 那些元素是可以被拖動的 |
| ghostClass | :ghostClass="ghostClass" 設置拖動元素的占位符類名,你的自定義樣式可能需要加!important才能生效,並把forceFallback屬性設置成true |
| chosenClass | :ghostClass="hostClass" 被選中目標的樣式,你的自定義樣式可能需要加!important才能生效,並把forceFallback屬性設置成true |
| dragClass | :dragClass="dragClass"拖動元素的樣式,你的自定義樣式可能需要加!important才能生效,並把forceFallback屬性設置成true |
| dataIdAttr | dataIdAttr: 'data-id' |
| forceFallback | 默認false,忽略HTML5的拖拽行為,因為h5里有個屬性也是可以拖動,你要自定義ghostClass chosenClass dragClass樣式時,建議forceFallback設置為true |
| fallbackClass | 默認false,克隆的DOM元素的類名 |
| allbackOnBody | 默認false,克隆的元素添加到文檔的body中 |
| fallbackTolerance | 拖拽之前應該移動的px |
| scroll | 默認true,有滾動區域是否允許拖拽 |
| scrollFn | 滾動回調函數 |
| scrollSensitivity | 距離滾動區域多遠時,滾動滾動條 |
| scrollSpeed | 滾動速度 |
例:
數組元素位置隨意可拖動
<template>
<div>
<br>
<br><el-link href="https://www.itxst.com/vue-draggable/tutorial.html" target="target">文檔</el-link>
<br>{{ list }}
<br>
<br>
<vuedraggable v-model="list" class="content">
<template v-for="item,key in list">
<el-tag :key="key" class="item">{{ item }}</el-tag>
</template>
</vuedraggable>
</div>
</template>
<script>
import vuedraggable from 'vuedraggable'
export default {
components: { vuedraggable },
data() {
return {
list: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
}
}
}
</script>
<style>
.item
{
margin:0 10px
}
.content
{
background: gray;
}
</style>
