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

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

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

一、實(shí)現(xiàn)滑塊跟隨鼠標(biāo)移動(dòng)效果

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

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

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

1.2 計(jì)算滑塊移動(dòng)距離和大圖顯示效果

1.2.1 計(jì)算蒙版滑塊可移動(dòng)距離

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

1.2.2 經(jīng)過(guò)放大之后的大圖顯示

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

const left = ref(0)
const top = ref(0)
const positionX = ref(0)
const positionY = ref(0)
watch([elementX, elementY, isOutside], () => {
  // 鼠標(biāo)移出圖片區(qū)域 不需要計(jì)算
  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"
]

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

// 圖片放大鏡效果
const targetRef = ref(null) // 目標(biāo)元素
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], () => {
  // 鼠標(biāo)移出圖片區(qū)域 不需要計(jì)算
  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">
    <!-- 左側(cè)大圖-->
    <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  將來(lái)控制背景圖的移動(dòng)來(lái)實(shí)現(xiàn)放大的效果查看 background-position
    background-size: 800px 800px;
    background-color: #f8f8f8;
  }

  .layer {
    width: 200px;
    height: 200px;
    background: rgba(0, 0, 0, 0.2);
    // 絕對(duì)定位 然后跟隨咱們鼠標(biāo)控制left和top屬性就可以讓滑塊移動(dòng)起來(lái)
    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>