如何使用Vue3實現一個飄逸元素拖拽功能

如何使用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中的拖拽功能有所幫助。如果你有任何問題或建議，歡迎在評論區留言討論。