vue3圖片放大鏡效果實現(xiàn)的完整教程

更新時間：2025年11月04日 10:46:32 作者：H_HX126

在Vue中實現(xiàn)放大鏡效果,主要是為了增強用戶體驗,讓用戶在查看商品圖片時能更清晰地觀察細節(jié),這篇文章主要介紹了vue3圖片放大鏡效果實現(xiàn)的相關資料,文中通過代碼介紹的非常詳細,需要的朋友可以參考下

一、實現(xiàn)滑塊跟隨鼠標移動效果

1.1 引入vueuse 中的 useMouseInElement 函數(shù)

useMouseInElement：獲取鼠標在目標元素的位置px
elementX：鼠標在目標元素的X位置
elementY：鼠標在目標元素的Y位置
isOutside：鼠標是否移出了目標元素

import { useMouseInElement } from '@vueuse/core'
const { elementX, elementY, isOutside } = useMouseInElement(targetRef)

1.2 計算滑塊移動距離和大圖顯示效果

1.2.1 計算蒙版滑塊可移動距離

left：蒙版滑塊距離目標元素左側距離
top：蒙版滑塊距離目標元素頂部距離
數(shù)值計算說明
- 鼠標可以任意移動，滑塊只能在目標元素的盒子里移動
- 鼠標移動 x 和 y 方向小于 100px 的位置時，蒙版滑塊會超出目標盒子，需要把滑塊的 left 和 top 值固定為最小值 0，避免滑塊繼續(xù)移動超出目標盒子
- 鼠標移動到 x 的 300px 或者 y 的 300px 位置時，蒙版滑塊也會超出目標盒子，需要把滑塊的 left 和 top 值固定為最大值 200，避免滑塊繼續(xù)移動超出目標盒子

1.2.2 經過放大之后的大圖顯示

這里大圖的盒子大小和目標元素盒子大小一樣 400px，圖片為大圖盒子的背景圖，背景圖片的大小是盒子大小的2倍，相當于圖片放大2倍的效果
大圖顯示的位置與蒙版滑塊的位置一樣，由于背景圖放大了兩倍，所以這里要乘2
大圖移動效果與滑塊移動位置相反，滑塊往左移，大圖位置相應往右移，視覺交互更協(xié)調，所以背景圖的位置要加 - 號，具體效果件見最下方視頻

const left = ref(0)
const top = ref(0)
const positionX = ref(0)
const positionY = ref(0)
watch([elementX, elementY, isOutside], () => {
  // 鼠標移出圖片區(qū)域 不需要計算
  if(isOutside.value) return
  // 橫向
  if(elementX.value > 100 && elementX.value < 300) {
    left.value = elementX.value - 100
  }
  // 縱向
  if(elementY.value > 100 && elementY.value < 300) {
    top.value = elementY.value - 100
  }
  // 邊界控制
  if(elementX.value < 100) { left.value = 0 }
  if(elementX.value > 300) { left.value = 200 }
  if(elementY.value < 100) { top.value = 0 }
  if(elementY.value > 300) { top.value = 200 }

  // 控制放大之后大圖的顯示
  positionX.value = -left.value * 2
  positionY.value = -top.value * 2
})
</script>

1.3 完整代碼

<script setup>
import { ref, watch } from 'vue'
import { useMouseInElement } from '@vueuse/core'
// 圖片列表
const imageList = [
  "https://yanxuan-item.nosdn.127.net/d917c92e663c5ed0bb577c7ded73e4ec.png",
  "https://yanxuan-item.nosdn.127.net/e801b9572f0b0c02a52952b01adab967.jpg",
  "https://yanxuan-item.nosdn.127.net/b52c447ad472d51adbdde1a83f550ac2.jpg",
  "https://yanxuan-item.nosdn.127.net/f93243224dc37674dfca5874fe089c60.jpg",
  "https://yanxuan-item.nosdn.127.net/f881cfe7de9a576aaeea6ee0d1d24823.jpg"
]

// 鼠標懸浮小圖  顯示相應大圖
const activeIndex = ref(0) // 當前顯示的圖片索引
const enterHandler = (i) => {
  activeIndex.value = i
}

// 圖片放大鏡效果
const targetRef = ref(null) // 目標元素
const { elementX, elementY, isOutside } = useMouseInElement(targetRef)
const left = ref(0)
const top = ref(0)
const positionX = ref(0)
const positionY = ref(0)
watch([elementX, elementY, isOutside], () => {
  // 鼠標移出圖片區(qū)域 不需要計算
  if(isOutside.value) return
  // 橫向
  if(elementX.value > 100 && elementX.value < 300) {
    left.value = elementX.value - 100
  }
  // 縱向
  if(elementY.value > 100 && elementY.value < 300) {
    top.value = elementY.value - 100
  }
  // 邊界控制
  if(elementX.value < 100) { left.value = 0 }
  if(elementX.value > 300) { left.value = 200 }
  if(elementY.value < 100) { top.value = 0 }
  if(elementY.value > 300) { top.value = 200 }

  // 控制放大之后大圖的顯示
  positionX.value = -left.value * 2
  positionY.value = -top.value * 2
})
</script>


<template>
  <div class="goods-image">
    <!-- 左側大圖-->
    <div class="middle" ref="targetRef">
      <img :src="imageList[activeIndex]" alt="" />
      <!-- 蒙層小滑塊 -->
      <div class="layer" :style="{ left: `${left}px`, top: `${top}px` }" v-show="!isOutside"></div>
    </div>
    <!-- 小圖列表 -->
    <ul class="small">
      <li v-for="(img, i) in imageList" :key="i" @mouseenter="enterHandler(i)" :class="{ active: i===activeIndex }">
        <img :src="img" alt="" />
      </li>
    </ul>
    <!-- 放大鏡大圖 -->
    <div class="large" :style="[
      {
        backgroundImage: `url(${imageList[activeIndex]})`,
        backgroundPositionX: `${positionX}px`,
        backgroundPositionY: `${positionY}px`,
      },
    ]" v-show="!isOutside"></div>
  </div>
</template>

<style scoped lang="scss">
.goods-image {
  width: 480px;
  height: 400px;
  position: relative;
  display: flex;

  .middle {
    width: 400px;
    height: 400px;
    background: #f5f5f5;
  }

  .large {
    position: absolute;
    top: 0;
    left: 412px;
    width: 400px;
    height: 400px;
    z-index: 500;
    box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
    background-repeat: no-repeat;
    // 背景圖:盒子的大小 = 2:1  將來控制背景圖的移動來實現(xiàn)放大的效果查看 background-position
    background-size: 800px 800px;
    background-color: #f8f8f8;
  }

  .layer {
    width: 200px;
    height: 200px;
    background: rgba(0, 0, 0, 0.2);
    // 絕對定位 然后跟隨咱們鼠標控制left和top屬性就可以讓滑塊移動起來
    left: 0;
    top: 0;
    position: absolute;
  }

  .small {
    width: 80px;

    li {
      width: 68px;
      height: 68px;
      margin-left: 12px;
      margin-bottom: 15px;
      cursor: pointer;

      &:hover,
      &.active {
        border: 2px solid $xtxColor;
      }
    }
  }
}
</style>