vue.draggable.next 中文文档

vue.draggable vue3 版本在工作台中的应用场景

本文将模拟 vue.draggable vue3 版本在工作台中的应用场景,假设工作台分为3列用户可以自由拖拽任何一列,但是消息通知模块不允许拖拽和停靠只能在第一列的最顶部,5年前入职一家公司第一件事情就是把工作台的模块改成可以拖拽的效果,但是由于我之前10年一直是服务器后端开发,也不大爱用第三方插件,除非像jquery vue这种大红大紫的插件,于是花了2天时间手写了一个拖拽插件,如果当时我知道vuedraggable我绝对不会去做这种吃力不讨好的事情。

数据结构

const state = reactive({
  /*工作台的数据结构
    disabledMove:禁止移动
    disabledPark:禁止停靠
  */
  modules: {
    group1: [
      { name: "消息", id: 1, disabledMove: true, disabledPark: true },
      { name: "库存", id: 2, disabledMove: false, disabledPark: false },
      { name: "销量", id: 3, disabledMove: false, disabledPark: false },
      { name: "日志", id: 4, disabledMove: false, disabledPark: false },
    ],
    group2: [
      { name: "订单", id: 5, disabledMove: false, disabledPark: false },
      { name: "员工", id: 6, disabledMove: false, disabledPark: false },
      { name: "报表", id: 7, disabledMove: false, disabledPark: false },
    ],
    group3: [
      { name: "系统", id: 8, disabledMove: false, disabledPark: false },
      { name: "审核", id: 9, disabledMove: false, disabledPark: false },
    ],
  },
});

属性列表

 <draggable
        :list="state.modules.group1" // 数据源
        ghost-class="ghost"          // 宿主样式
        handle=".move"               // 鼠标点击在那个元素上面才能拖拽
        filter=".forbid"             // 禁止拖拽的元素
        :force-fallback="true"       // 忽略HTML5的DnD行为,并强制退出
        chosen-class="chosenClass"   // 选中的样式
        animation="300"              // 动画效果
        @start="onStart"             // 开始拖拽事件
        @end="onEnd"                 // 结束拖拽事件  
        group="group1"               // 分组,相同的组名可以相互拖拽
        :touch-start-threshold="50"  // 交换间隔的大小,可以查看菜单对应的属性说明
        :move="onMove"               // 拖拽中事件,可以用来控制是否允许停靠
        :fallback-class="true"       
        :fallback-on-body="true"
        :fallback-tolerance="50"
 >

在线试一试

完整代码

<template>
  <div class="itxst">
    <div class="group">
      <draggable
        :list="state.modules.group1"
        ghost-class="ghost"
        handle=".move"
        filter=".forbid"
        :force-fallback="true"
        chosen-class="chosenClass"
        animation="300"
        @start="onStart"
        @end="onEnd"
        group="group1"
        :fallback-class="true"
        :fallback-on-body="true"
        :touch-start-threshold="50"
        :fallback-tolerance="50"
        :move="onMove"
      >
        <template #item="{ element }">
          <div :class="element.disabledMove ? 'forbid item' : 'item'">
            <label class="move">{{ element.name }}</label>
            <p v-html="element.name=='消息'?'消息不允许拖拽和停靠<br>www.itxst.com':'内容....'"></p>
          </div>
        </template>
      </draggable>
    </div>
    <div class="group">
      <draggable
        :list="state.modules.group2"
        ghost-class="ghost"
        handle=".move"
        filter=".forbid"
        :force-fallback="true"
        chosen-class="chosenClass"
        animation="300"
        @start="onStart"
        @end="onEnd"
        group="group1"
        :fallback-class="true"
        :fallback-on-body="true"
        :touch-start-threshold="50"
        :fallback-tolerance="50"
        :move="onMove"
      >
        <template #item="{ element }">
          <div :class="element.disabledMove ? 'forbid item' : 'item'">
            <label class="move">{{ element.name }}</label>
            <p>内容....</p>
          </div>
        </template>
      </draggable>
    </div>
    <div class="group">
      <draggable
        :list="state.modules.group3"
        ghost-class="ghost"
        handle=".move"
        filter=".forbid"
        :force-fallback="true"
        chosen-class="chosenClass"
        animation="300"
        @start="onStart"
        @end="onEnd"
        group="group1"
        :fallback-class="true"
        :fallback-on-body="true"
        :touch-start-threshold="50"
        :fallback-tolerance="50"
        :move="onMove"
      >
        <template #item="{ element }">
          <div :class="element.disabledMove ? 'forbid item' : 'item'">
            <label class="move">{{ element.name }}</label>
            <p>内容....</p>
          </div>
        </template>
      </draggable>
    </div>
  </div>
</template>
<script setup>
import { ref, reactive } from "vue";
//导入draggable组件
import draggable from "vuedraggable";

const state = reactive({
  /*工作台的数据结构
    disabledMove:禁止移动
    disabledPark:禁止停靠
  */
  modules: {
    group1: [
      { name: "消息", id: 1, disabledMove: true, disabledPark: true },
      { name: "库存", id: 2, disabledMove: false, disabledPark: false },
      { name: "销量", id: 3, disabledMove: false, disabledPark: false },
      { name: "日志", id: 4, disabledMove: false, disabledPark: false },
    ],
    group2: [
      { name: "订单", id: 5, disabledMove: false, disabledPark: false },
      { name: "员工", id: 6, disabledMove: false, disabledPark: false },
      { name: "报表", id: 7, disabledMove: false, disabledPark: false },
    ],
    group3: [
      { name: "系统", id: 8, disabledMove: false, disabledPark: false },
      { name: "审核", id: 9, disabledMove: false, disabledPark: false },
    ],
  },
});

//拖拽开始的事件
const onStart = () => {
  console.log("开始拖拽");
};

//拖拽结束的事件
const onEnd = () => {
  console.log("结束拖拽");
};

const onMove = (e, originalEvent) => {
  //不允许停靠
  if (e.relatedContext.element.disabledPark == true) return false;

  return true;
};
</script>
<style >
body {
  padding: 0px;
  margin: 0px;
  background-color: #f1f1f1;
}
.itxst {
  background-color: #f1f1f1;
  display: flex;
  justify-content: space-between;
  align-content: space-around;
  padding: 20px;
}

.group {
  display: flex;
  flex-direction: column;
  justify-content: flex-start;
  align-content: center;
  width: 32%;
}
.item {
  border: solid 1px #ddd;
  padding: 0px;
  text-align: left;
  background-color: #fff;
  margin-bottom: 10px;
  display: flex;
  flex-direction: column;
  min-height: 260px;
  user-select: none;
}

.item > label {
  border-bottom: solid 1px #ddd;
  padding: 6px 10px;
  color: #333;
}
.item > label:hover {
  cursor: move;
}
.item > p {
  padding: 6px 10px;
  color: #666;
}
.ghost {
  border: solid 1px rgb(19, 41, 239) !important;
}
.chosenClass {
  opacity: 1;
  border: solid 1px red;
}
.fallbackClass {
  background-color: aquamarine;
}
</style>
Catalog
快速入门 常见场景 工作台应用场景 拖拽普通表格行与列 属性列表 sort 是否允许排序 group 分组拖拽