当前位置：首页 > VUE

Vue实现拖拽布局

2026-03-29 15:33:37VUE

Vue 拖拽布局实现方法

使用原生 HTML5 拖拽 API

在 Vue 中可以直接使用 HTML5 的拖拽 API 实现基础拖拽功能。通过 draggable 属性、dragstart、dragend 等事件实现元素拖拽。

<template>
  <div 
    draggable="true"
    @dragstart="handleDragStart"
    @dragend="handleDragEnd"
  >
    可拖拽元素
  </div>
</template>

<script>
export default {
  methods: {
    handleDragStart(e) {
      e.dataTransfer.setData('text/plain', e.target.id)
    },
    handleDragEnd(e) {
      // 拖拽结束处理
    }
  }
}
</script>

使用第三方库 vue-draggable

vue-draggable 是基于 Sortable.js 的 Vue 拖拽组件，适合列表排序和网格布局。

安装依赖：

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-grid-layout 库。

Vue实现拖拽布局

安装依赖：

npm install vue-grid-layout

示例代码：

<template>
  <grid-layout
    :layout.sync="layout"
    :col-num="12"
    :row-height="30"
    :is-draggable="true"
  >
    <grid-item
      v-for="item in layout"
      :x="item.x"
      :y="item.y"
      :w="item.w"
      :h="item.h"
      :i="item.i"
      :key="item.i"
    >
      {{ item.i }}
    </grid-item>
  </grid-layout>
</template>

<script>
import { GridLayout, GridItem } from 'vue-grid-layout'

export default {
  components: { GridLayout, GridItem },
  data() {
    return {
      layout: [
        { x: 0, y: 0, w: 2, h: 2, i: '1' },
        { x: 2, y: 0, w: 2, h: 4, i: '2' }
      ]
    }
  }
}
</script>

自定义拖拽实现

对于需要完全自定义的场景，可以结合鼠标事件实现：

<template>
  <div
    class="draggable-item"
    @mousedown="startDrag"
    @mousemove="onDrag"
    @mouseup="endDrag"
    :style="itemStyle"
  >
    自定义拖拽元素
  </div>
</template>

<script>
export default {
  data() {
    return {
      isDragging: false,
      startX: 0,
      startY: 0,
      currentX: 0,
      currentY: 0
    }
  },
  computed: {
    itemStyle() {
      return {
        transform: `translate(${this.currentX}px, ${this.currentY}px)`
      }
    }
  },
  methods: {
    startDrag(e) {
      this.isDragging = true
      this.startX = e.clientX - this.currentX
      this.startY = e.clientY - this.currentY
    },
    onDrag(e) {
      if (!this.isDragging) return
      this.currentX = e.clientX - this.startX
      this.currentY = e.clientY - this.startY
    },
    endDrag() {
      this.isDragging = false
    }
  }
}
</script>