当前位置：首页 > VUE

vue组件的拖拽实现

2026-01-22 21:51:51VUE

使用 HTML5 原生拖拽 API

HTML5 提供了原生的拖拽 API，包括 draggable、dragstart、dragend、dragenter、dragover 和 drop 等事件。在 Vue 中可以通过事件绑定实现基础拖拽功能。

<template>
  <div>
    <div 
      draggable="true"
      @dragstart="handleDragStart"
      @dragend="handleDragEnd"
    >
      可拖拽元素
    </div>
    <div 
      @dragover.prevent
      @drop="handleDrop"
    >
      放置区域
    </div>
  </div>
</template>

<script>
export default {
  methods: {
    handleDragStart(e) {
      e.dataTransfer.setData('text/plain', '拖拽数据');
    },
    handleDrop(e) {
      const data = e.dataTransfer.getData('text/plain');
      console.log('接收到的数据:', data);
    }
  }
}
</script>

使用第三方库 vue-draggable

vue-draggable 是基于 Sortable.js 的 Vue 拖拽组件库，适用于列表排序、跨列表拖拽等复杂场景。

安装依赖：

npm install vuedraggable

基础用法：

<template>
  <draggable 
    v-model="list" 
    @end="onDragEnd"
  >
    <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' }
      ]
    };
  },
  methods: {
    onDragEnd() {
      console.log('排序后的列表:', this.list);
    }
  }
}
</script>

实现自定义拖拽指令

通过 Vue 自定义指令可以封装更灵活的拖拽逻辑，适合需要高度定制的场景。

<template>
  <div v-draggable @drag-start="logStart" @drag-end="logEnd">
    自定义指令拖拽元素
  </div>
</template>

<script>
export default {
  directives: {
    draggable: {
      inserted(el, binding) {
        el.setAttribute('draggable', true);
        el.addEventListener('dragstart', (e) => {
          binding.value && binding.value.onDragStart(e);
        });
        el.addEventListener('dragend', (e) => {
          binding.value && binding.value.onDragEnd(e);
        });
      }
    }
  },
  methods: {
    logStart(e) {
      console.log('开始拖拽', e);
    },
    logEnd(e) {
      console.log('结束拖拽', e);
    }
  }
}
</script>

跨组件拖拽通信

通过 Vuex 或事件总线实现跨组件拖拽数据传递，适用于复杂应用架构。

// store.js
import Vue from 'vue';
import Vuex from 'vuex';

Vue.use(Vuex);

export default new Vuex.Store({
  state: {
    draggedItem: null
  },
  mutations: {
    setDraggedItem(state, item) {
      state.draggedItem = item;
    }
  }
});

拖拽组件：

<template>
  <div 
    draggable 
    @dragstart="dragStart"
  >
    拖拽源
  </div>
</template>

<script>
export default {
  methods: {
    dragStart() {
      this.$store.commit('setDraggedItem', { id: 123 });
    }
  }
}
</script>

放置组件：

<template>
  <div @drop="handleDrop">
    放置目标
  </div>
</template>

<script>
export default {
  methods: {
    handleDrop() {
      const item = this.$store.state.draggedItem;
      console.log('接收到拖拽数据:', item);
    }
  }
}
</script>

移动端拖拽适配

移动端需要通过 touchstart、touchmove 和 touchend 事件模拟拖拽行为。

<template>
  <div 
    @touchstart="touchStart"
    @touchmove="touchMove"
    @touchend="touchEnd"
    :style="dragStyle"
  >
    移动端拖拽元素
  </div>
</template>

<script>
export default {
  data() {
    return {
      startX: 0,
      startY: 0,
      offsetX: 0,
      offsetY: 0
    };
  },
  computed: {
    dragStyle() {
      return {
        transform: `translate(${this.offsetX}px, ${this.offsetY}px)`
      };
    }
  },
  methods: {
    touchStart(e) {
      this.startX = e.touches[0].clientX;
      this.startY = e.touches[0].clientY;
    },
    touchMove(e) {
      this.offsetX = e.touches[0].clientX - this.startX;
      this.offsetY = e.touches[0].clientY - this.startY;
    },
    touchEnd() {
      // 拖拽结束处理
    }
  }
}
</script>

vue组件的拖拽实现