vue3实现对自定义组件自由拖动效果

 更新时间:2025年04月28日 12:02:18   作者:℡52Hz★  
在数据可视化看板开发中,组件的自由拖拽功能能极大提升交互体验,本文将基于Vue3生态,从零开始解析如何实现一个支持自由拖拽的容器组件,感兴趣的朋友一起看看吧

在数据可视化看板开发中,组件的自由拖拽功能能极大提升交互体验。本文将基于Vue3生态,从零开始解析如何实现一个支持自由拖拽的容器组件。

一、核心实现原理

1.组件定位基础

使用position: fixed实现绝对定位,通过动态样式绑定left/top控制位置,@mousedown事件来触发拖曳效果。

<template>
  <div class="left-admin" @mousedown="startDrag" :style="{ left: panelPosition.x + 'px', top: panelPosition.y + 'px' }">
  </div>
</template>
<style lang="less" scoped>
.left-admin {
  position: fixed;
  cursor: move;
}
</style>

2.拖曳过程实现

(1)定义初始屏幕宽度、位置及判断条件

const panelWidth = 443//初始宽度
const panelPosition = ref({//初始位置
  x: 8,
  y: 80
  // x: 0.5,
  // y: 0.5
})
let isDragging = false//是否拖拽中
let startX = 0//开始X坐标
let startY = 0//开始Y坐标
let initialX = 0//初始X坐标
let initialY = 0//初始Y坐标

(2)鼠标按下事件

当鼠标进行拖动时,获取获取鼠标的X、Y坐标,并且绑定鼠标的移动和释放事件

// 鼠标按下事件
const startDrag = e => {
  isDragging = true
  startX = e.clientX//获取鼠标X坐标
  startY = e.clientY//获取鼠标Y坐标
  initialX = panelPosition.value.x//获取初始X坐标
  initialY = panelPosition.value.y//获取初始Y坐标
  document.addEventListener('mousemove', onDrag)//绑定鼠标移动事件  
  document.addEventListener('mouseup', stopDrag)//绑定鼠标释放事件
}

(3)鼠标移动事件

// 鼠标移动事件
const onDrag = e => {
  // 防止拖拽过程中鼠标点击导致的页面闪烁
  if (!isDragging) return
  //计算移动距离
  const dx = e.clientX - startX
  const dy = e.clientY - startY
  // 添加边界限制
  let newX = initialX + dx
  let newY = initialY + dy
  newX = Math.max(newX, 8)//最小值
  newX = Math.min(newX, window.innerWidth - panelWidth - 8)//最大值
  panelPosition.value = {//更新位置数据
    x: newX,
    y: newY
  }
}

(4)鼠标释放事件

// 鼠标释放事件
const stopDrag = () => {
  isDragging = false
  document.removeEventListener('mousemove', onDrag)// 鼠标移动事件
  document.removeEventListener('mouseup', stopDrag)// 鼠标释放事件
}

(5)组件卸载时清理事件

// 组件卸载时清理事件
onBeforeUnmount(() => {
  document.removeEventListener('mousemove', onDrag)
  document.removeEventListener('mouseup', stopDrag)
})

二、全部代码

以下代码是实际项目中使用到的,重要的过程代码对应以上核心实现原理这里,可根据自行项目需要进行摘取

<template>
  <div class="left-admin" @mousedown="startDrag" :style="{ left: panelPosition.x + 'px', top: panelPosition.y + 'px' }">
    <!-- <div class="top-title">
      <h1>各行政区检修工单统计(本月度)</h1>
    </div> -->
    <div class="admin-top">
      <h1>{{ adminTitle }}</h1>
      <img src="@/assets/images/page/close.svg" class="close-btn" @click="closeLeftAdmin" />
    </div>
    <div class="chart">
      <radarChart :indicatorData="indicatorData" :radarData="radarData" :chartColor="props.chartColor" />
    </div>
  </div>
</template>
<script setup>
import { onMounted, ref, onBeforeUnmount, getCurrentInstance } from 'vue'
import radarChart from '@/components/chart/radar-chart.vue'
import { getDevRepairCount } from '@/api/home/home-left.js'
const props = defineProps(['chartColor'])
const emit = defineEmits(['closeLeftAdmin'])
const context = getCurrentInstance()?.appContext.config.globalProperties
const dayjs = context?.$dayjs
const adminTitle = ref('各行政区检修工单统计(本月度)')
const indicatorData = ref([
  // { name: '张家港市' },
  // { name: '吴江区' },
  // { name: '吴中区' },
  // { name: '姑苏区' },
  // { name: '虎丘区' },
  // { name: '相城区' },
  // { name: '昆山市' },
  // { name: '太仓市' },
  // { name: '常熟市' }
])
const radarData = ref([
  // { value: [1200, 3000, 4000, 1000, 30000, 3000, 35000, 50000, 18000] }
  // { name: '已开工', value: [5200, 2000, 30000, 2000, 10000, 18000] },
  // { name: '未开工', value: [3200, 2000, 5000, 2000, 10000, 18000] },
  // { name: '已竣工', value: [2200, 2000, 5000, 2000, 10000, 18000] },
  // { name: '当值开竣工', value: [4200, 3000, 20000, 35000, 50000, 18000] },
  // { name: '改期和延期', value: [5000, 14000, 28000, 26000, 42000, 21000] }
])
const closeLeftAdmin = () => {
  emit('closeLeftAdmin')
}
// 新增状态
// const panelPosition = ref({ x: 8, y: 80 })
const panelWidth = 443
const panelPosition = ref({
  x: 8,
  y: 80
  // x: 0.5,
  // y: 0.5
})
let isDragging = false
let startX = 0
let startY = 0
let initialX = 0
let initialY = 0
// 鼠标按下事件
const startDrag = e => {
  isDragging = true
  startX = e.clientX
  startY = e.clientY
  initialX = panelPosition.value.x
  initialY = panelPosition.value.y
  document.addEventListener('mousemove', onDrag)
  document.addEventListener('mouseup', stopDrag)
}
// 鼠标移动事件
const onDrag = e => {
  if (!isDragging) return
  const dx = e.clientX - startX
  const dy = e.clientY - startY
  let newX = initialX + dx
  let newY = initialY + dy
  newX = Math.max(newX, 8)
  newX = Math.min(newX, window.innerWidth - panelWidth - 8)
  panelPosition.value = {
    x: newX,
    y: newY
  }
}
// 鼠标释放事件
const stopDrag = () => {
  isDragging = false
  document.removeEventListener('mousemove', onDrag)
  document.removeEventListener('mouseup', stopDrag)
}
// 组件卸载时清理事件
onBeforeUnmount(() => {
  document.removeEventListener('mousemove', onDrag)
  document.removeEventListener('mouseup', stopDrag)
})
</script>
<style lang="less" scoped>
.left-admin {
  position: fixed;
  cursor: move;
}
</style>

到此这篇关于vue3实现对自定义组件自由拖动效果的文章就介绍到这了,更多相关vue自定义组件自由拖动内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue生成token保存在客户端localStorage中的方法

    vue生成token保存在客户端localStorage中的方法

    本篇文章主要介绍了vue生成token保存在客户端localStorage中的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-10-10
  • Vue3+Antd实现弹框显示内容并加入复制按钮

    Vue3+Antd实现弹框显示内容并加入复制按钮

    这篇文章主要介绍了Vue3+Antd实现弹框显示内容并加入复制按钮,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2023-12-12
  • 浅谈Vue DIFF

    浅谈Vue DIFF

    本文主要介绍了浅谈Vue DIFF,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-05-05
  • vue3 setup点击跳转页面的实现示例

    vue3 setup点击跳转页面的实现示例

    本文主要介绍了vue3 setup点击跳转页面的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-10-10
  • vue+elementUI实现简单日历功能

    vue+elementUI实现简单日历功能

    这篇文章主要为大家详细介绍了vue+elementUI实现简单日历功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-09-09
  • vue-element-admin登录拦截设置白名单方式

    vue-element-admin登录拦截设置白名单方式

    这篇文章主要介绍了vue-element-admin登录拦截设置白名单方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-03-03
  • vue v-viewer组件使用示例详解(v-viewer轮播图)

    vue v-viewer组件使用示例详解(v-viewer轮播图)

    这篇文章主要介绍了vue v-viewer组件使用示例详解(v-viewer轮播图),本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-02-02
  • el-table 动态合并不定项多级表头的方法

    el-table 动态合并不定项多级表头的方法

    本文主要介绍了el-table 动态合并不定项多级表头的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • Vue中Axios从远程/后台读取数据

    Vue中Axios从远程/后台读取数据

    今天小编就为大家分享一篇关于Vue中Axios从远程/后台读取数据,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-01-01
  • vue + element-plus自定义表单验证(修改密码业务)的示例

    vue + element-plus自定义表单验证(修改密码业务)的示例

    这篇文章主要介绍了vue + element-plus自定义表单验证(修改密码业务),本文通过实例代码给大家介绍的非常详细,感兴趣的朋友一起看看吧
    2025-04-04

最新评论