当前位置：首页 > VUE

vue实现组件可拖拽

2026-02-22 10:33:44VUE

Vue实现组件拖拽的方法

使用HTML5原生拖拽API

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

<template>
  <div 
    draggable="true"
    @dragstart="handleDragStart"
    @dragend="handleDragEnd"
    class="draggable-item">
    拖拽我
  </div>
  <div 
    @dragover.prevent
    @drop="handleDrop"
    class="drop-zone">
    放置区域
  </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组件，提供了更完善的拖拽功能，支持列表排序、跨列表拖拽等场景。

安装依赖：

vue实现组件可拖拽

npm install vuedraggable

基本用法：

<template>
  <draggable v-model="myArray" group="people" @start="drag=true" @end="drag=false">
    <div v-for="element in myArray" :key="element.id">
      {{ element.name }}
    </div>
  </draggable>
</template>

<script>
import draggable from 'vuedraggable'

export default {
  components: { draggable },
  data() {
    return {
      myArray: [
        { id: 1, name: 'Item 1' },
        { id: 2, name: 'Item 2' }
      ]
    }
  }
}
</script>

自定义拖拽指令

可以通过Vue自定义指令实现更灵活的拖拽控制，适合需要高度定制化的场景。

vue实现组件可拖拽

Vue.directive('drag', {
  bind(el, binding) {
    el.style.position = 'absolute'
    let startX, startY, initialX, initialY

    el.addEventListener('mousedown', startDrag)

    function startDrag(e) {
      startX = e.clientX
      startY = e.clientY
      initialX = el.offsetLeft
      initialY = el.offsetTop

      document.addEventListener('mousemove', drag)
      document.addEventListener('mouseup', stopDrag)
      e.preventDefault()
    }

    function drag(e) {
      const dx = e.clientX - startX
      const dy = e.clientY - startY
      el.style.left = initialX + dx + 'px'
      el.style.top = initialY + dy + 'px'
    }

    function stopDrag() {
      document.removeEventListener('mousemove', drag)
      document.removeEventListener('mouseup', stopDrag)
    }
  }
})

使用拖拽事件实现限制区域

可以通过计算鼠标位置和元素边界，实现只能在特定区域内拖拽的效果。

methods: {
  handleDrag(e) {
    const container = this.$refs.container
    const item = this.$refs.draggable
    const containerRect = container.getBoundingClientRect()
    const itemRect = item.getBoundingClientRect()

    let left = e.clientX - containerRect.left - itemRect.width/2
    let top = e.clientY - containerRect.top - itemRect.height/2

    // 限制在容器范围内
    left = Math.max(0, Math.min(left, containerRect.width - itemRect.width))
    top = Math.max(0, Math.min(top, containerRect.height - itemRect.height))

    item.style.left = left + 'px'
    item.style.top = top + 'px'
  }
}

触摸设备支持

为了在移动设备上支持拖拽，需要添加触摸事件处理。

el.addEventListener('touchstart', handleTouchStart)
el.addEventListener('touchmove', handleTouchMove)

function handleTouchStart(e) {
  const touch = e.touches[0]
  startX = touch.clientX
  startY = touch.clientY
}

function handleTouchMove(e) {
  const touch = e.touches[0]
  const dx = touch.clientX - startX
  const dy = touch.clientY - startY
  el.style.transform = `translate(${dx}px, ${dy}px)`
}

每种方法适用于不同场景，HTML5原生API适合简单拖拽，vue-draggable适合列表排序，自定义指令和限制区域适合游戏或特殊交互需求。