如何使用Vue3实现一个飘逸元素拖拽功能

发布时间：2023-03-31 09:20:04 作者：iii
来源：亿速云阅读：128

如何使用Vue3实现一个飘逸元素拖拽功能

在现代Web开发中，拖拽功能是一个非常常见的需求，尤其是在构建交互性强的应用时。Vue3作为一款流行的前端框架，提供了强大的响应式系统和组件化开发能力，使得实现拖拽功能变得更加简单和高效。本文将详细介绍如何使用Vue3实现一个飘逸元素拖拽功能，并通过代码示例逐步讲解实现过程。

1. 项目初始化

首先，我们需要创建一个Vue3项目。如果你还没有安装Vue CLI，可以通过以下命令进行安装：

npm install -g @vue/cli

然后，使用Vue CLI创建一个新的项目：

vue create vue3-drag-demo

在项目创建过程中，选择Vue3作为项目的默认版本。创建完成后，进入项目目录并启动开发服务器：

cd vue3-drag-demo
npm run serve

2. 创建拖拽组件

接下来，我们将在项目中创建一个拖拽组件。在src/components目录下创建一个名为Draggable.vue的文件，并编写以下代码：

<template>
  <div
    class="draggable"
    :style="style"
    @mousedown="startDrag"
    @mousemove="onDrag"
    @mouseup="stopDrag"
    @mouseleave="stopDrag"
  >
    <slot></slot>
  </div>
</template>

<script>
import { ref, computed } from 'vue';

export default {
  setup() {
    const isDragging = ref(false);
    const startX = ref(0);
    const startY = ref(0);
    const offsetX = ref(0);
    const offsetY = ref(0);

    const style = computed(() => ({
      transform: `translate(${offsetX.value}px, ${offsetY.value}px)`,
      cursor: isDragging.value ? 'grabbing' : 'grab',
    }));

    const startDrag = (event) => {
      isDragging.value = true;
      startX.value = event.clientX - offsetX.value;
      startY.value = event.clientY - offsetY.value;
    };

    const onDrag = (event) => {
      if (isDragging.value) {
        offsetX.value = event.clientX - startX.value;
        offsetY.value = event.clientY - startY.value;
      }
    };

    const stopDrag = () => {
      isDragging.value = false;
    };

    return {
      style,
      startDrag,
      onDrag,
      stopDrag,
    };
  },
};
</script>

<style scoped>
.draggable {
  position: absolute;
  user-select: none;
}
</style>

代码解析

isDragging: 用于跟踪当前是否正在拖拽元素。
startX 和 startY: 记录鼠标按下时的初始位置。
offsetX 和 offsetY: 记录元素相对于初始位置的偏移量。
style: 计算属性，用于动态设置元素的transform样式，实现元素的移动。
startDrag: 当鼠标按下时，开始拖拽，并记录初始位置。
onDrag: 当鼠标移动时，如果正在拖拽，则更新元素的偏移量。
stopDrag: 当鼠标松开或离开元素时，停止拖拽。

3. 使用拖拽组件

现在，我们可以在主应用中使用这个拖拽组件。打开src/App.vue文件，并修改代码如下：

<template>
  <div id="app">
    <Draggable>
      <div class="box">拖拽我</div>
    </Draggable>
  </div>
</template>

<script>
import Draggable from './components/Draggable.vue';

export default {
  components: {
    Draggable,
  },
};
</script>

<style>
#app {
  font-family: Avenir, Helvetica, Arial, sans-serif;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-align: center;
  color: #2c3e50;
  margin-top: 60px;
}

.box {
  width: 100px;
  height: 100px;
  background-color: #42b983;
  color: white;
  display: flex;
  align-items: center;
  justify-content: center;
  border-radius: 10px;
}
</style>

代码解析

Draggable组件: 包裹了一个div元素，使其具有拖拽功能。
box类: 定义了一个简单的方形盒子，用于展示拖拽效果。

4. 实现飘逸效果

为了让拖拽效果更加自然，我们可以为元素添加一些飘逸效果。这可以通过在拖拽过程中添加缓动动画来实现。修改Draggable.vue文件中的onDrag方法如下：

const onDrag = (event) => {
  if (isDragging.value) {
    const targetX = event.clientX - startX.value;
    const targetY = event.clientY - startY.value;

    const ease = 0.1;
    offsetX.value += (targetX - offsetX.value) * ease;
    offsetY.value += (targetY - offsetY.value) * ease;
  }
};

代码解析

ease: 缓动系数，控制拖拽的平滑程度。值越小，拖拽效果越平滑。
targetX 和 targetY: 计算目标位置。
offsetX 和 offsetY: 通过缓动公式逐步逼近目标位置，实现飘逸效果。

5. 添加边界限制

为了防止元素被拖拽出可视区域，我们可以为拖拽添加边界限制。修改Draggable.vue文件中的onDrag方法如下：

const onDrag = (event) => {
  if (isDragging.value) {
    const targetX = event.clientX - startX.value;
    const targetY = event.clientY - startY.value;

    const ease = 0.1;
    offsetX.value += (targetX - offsetX.value) * ease;
    offsetY.value += (targetY - offsetY.value) * ease;

    // 边界限制
    const maxX = window.innerWidth - 100; // 假设元素宽度为100px
    const maxY = window.innerHeight - 100; // 假设元素高度为100px

    offsetX.value = Math.max(0, Math.min(offsetX.value, maxX));
    offsetY.value = Math.max(0, Math.min(offsetY.value, maxY));
  }
};

代码解析

maxX 和 maxY: 计算元素在可视区域内的最大偏移量。
Math.max 和 Math.min: 确保元素的偏移量不会超出边界。

6. 添加拖拽释放后的惯性效果

为了让拖拽效果更加逼真，我们可以在拖拽释放后添加惯性效果。修改Draggable.vue文件如下：

<template>
  <div
    class="draggable"
    :style="style"
    @mousedown="startDrag"
    @mousemove="onDrag"
    @mouseup="stopDrag"
    @mouseleave="stopDrag"
  >
    <slot></slot>
  </div>
</template>

<script>
import { ref, computed, onMounted, onUnmounted } from 'vue';

export default {
  setup() {
    const isDragging = ref(false);
    const startX = ref(0);
    const startY = ref(0);
    const offsetX = ref(0);
    const offsetY = ref(0);
    const velocityX = ref(0);
    const velocityY = ref(0);
    const lastTime = ref(0);

    const style = computed(() => ({
      transform: `translate(${offsetX.value}px, ${offsetY.value}px)`,
      cursor: isDragging.value ? 'grabbing' : 'grab',
    }));

    const startDrag = (event) => {
      isDragging.value = true;
      startX.value = event.clientX - offsetX.value;
      startY.value = event.clientY - offsetY.value;
      velocityX.value = 0;
      velocityY.value = 0;
    };

    const onDrag = (event) => {
      if (isDragging.value) {
        const targetX = event.clientX - startX.value;
        const targetY = event.clientY - startY.value;

        const ease = 0.1;
        offsetX.value += (targetX - offsetX.value) * ease;
        offsetY.value += (targetY - offsetY.value) * ease;

        // 边界限制
        const maxX = window.innerWidth - 100; // 假设元素宽度为100px
        const maxY = window.innerHeight - 100; // 假设元素高度为100px

        offsetX.value = Math.max(0, Math.min(offsetX.value, maxX));
        offsetY.value = Math.max(0, Math.min(offsetY.value, maxY));

        // 计算速度
        const now = performance.now();
        const deltaTime = now - lastTime.value;
        if (deltaTime > 0) {
          velocityX.value = (targetX - offsetX.value) / deltaTime;
          velocityY.value = (targetY - offsetY.value) / deltaTime;
        }
        lastTime.value = now;
      }
    };

    const stopDrag = () => {
      isDragging.value = false;
      applyInertia();
    };

    const applyInertia = () => {
      const friction = 0.95;
      const minVelocity = 0.1;

      const animate = () => {
        if (Math.abs(velocityX.value) > minVelocity || Math.abs(velocityY.value) > minVelocity) {
          offsetX.value += velocityX.value;
          offsetY.value += velocityY.value;

          // 边界限制
          const maxX = window.innerWidth - 100; // 假设元素宽度为100px
          const maxY = window.innerHeight - 100; // 假设元素高度为100px

          offsetX.value = Math.max(0, Math.min(offsetX.value, maxX));
          offsetY.value = Math.max(0, Math.min(offsetY.value, maxY));

          velocityX.value *= friction;
          velocityY.value *= friction;

          requestAnimationFrame(animate);
        }
      };

      requestAnimationFrame(animate);
    };

    return {
      style,
      startDrag,
      onDrag,
      stopDrag,
    };
  },
};
</script>

<style scoped>
.draggable {
  position: absolute;
  user-select: none;
}
</style>

代码解析

velocityX 和 velocityY: 记录元素的速度。
lastTime: 记录上一次拖拽的时间，用于计算速度。
applyInertia: 在拖拽释放后，应用惯性效果，使元素继续移动并逐渐停止。
friction: 摩擦系数，控制惯性效果的衰减速度。
minVelocity: 最小速度阈值，当速度低于该值时停止动画。

7. 总结

通过以上步骤，我们成功实现了一个具有飘逸效果的拖拽功能。Vue3的响应式系统和组合式API使得这一过程变得非常简单和直观。你可以根据实际需求进一步扩展和优化这个拖拽组件，例如添加多点触控支持、限制拖拽方向等。

希望本文对你理解和实现Vue3中的拖拽功能有所帮助。如果你有任何问题或建议，欢迎在评论区留言讨论。

如何使用Vue3实现一个飘逸元素拖拽功能

如何使用Vue3实现一个飘逸元素拖拽功能

1. 项目初始化

2. 创建拖拽组件

代码解析

3. 使用拖拽组件

代码解析

4. 实现飘逸效果

代码解析

5. 添加边界限制

代码解析

6. 添加拖拽释放后的惯性效果

代码解析

7. 总结

相关阅读