当前位置：首页 > VUE

vue 实现拖拽功能

2026-01-17 00:01:10VUE

Vue 实现拖拽功能的方法

使用 HTML5 原生拖拽 API

HTML5 提供了原生的拖拽 API，可以通过 draggable 属性、dragstart、dragend、dragover 和 drop 事件实现基础拖拽功能。

<template>
  <div 
    draggable="true"
    @dragstart="handleDragStart"
    @dragover.prevent
    @drop="handleDrop"
  >
    拖拽元素
  </div>
</template>

<script>
export default {
  methods: {
    handleDragStart(e) {
      e.dataTransfer.setData('text/plain', e.target.id);
    },
    handleDrop(e) {
      const id = e.dataTransfer.getData('text/plain');
      const draggableElement = document.getElementById(id);
      e.target.appendChild(draggableElement);
    }
  }
};
</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('拖拽结束');
    }
  }
};
</script>

自定义拖拽指令

通过 Vue 自定义指令实现更灵活的拖拽控制。

<template>
  <div v-draggable>可拖拽元素</div>
</template>

<script>
export default {
  directives: {
    draggable: {
      inserted(el) {
        el.draggable = true;
        el.style.cursor = 'move';

        el.addEventListener('dragstart', (e) => {
          e.dataTransfer.setData('text/plain', el.id);
        });
      }
    }
  }
};
</script>

拖拽限制与边界控制

添加边界检查和拖拽范围限制。

methods: {
  handleDragOver(e) {
    const rect = e.target.getBoundingClientRect();
    const x = e.clientX - rect.left;
    const y = e.clientY - rect.top;

    // 限制在容器内拖拽
    if (x < 0 || y < 0 || x > rect.width || y > rect.height) {
      return false;
    }
    e.target.style.left = `${x}px`;
    e.target.style.top = `${y}px`;
  }
}

拖拽数据同步

在拖拽过程中实时更新 Vue 数据模型。

data() {
  return {
    items: [],
    draggedItem: null
  };
},
methods: {
  handleDragStart(item) {
    this.draggedItem = item;
  },
  handleDrop(targetIndex) {
    if (this.draggedItem) {
      const draggedIndex = this.items.indexOf(this.draggedItem);
      this.items.splice(targetIndex, 0, this.items.splice(draggedIndex, 1)[0]);
    }
  }
}

以上方法可根据具体需求选择使用，HTML5 原生 API 适合简单场景，Vue.Draggable 适合列表排序，自定义指令则提供最大灵活性。

vue 实现拖拽功能