vue3图片放大镜效果实现的完整教程

 更新时间:2025年11月04日 10:46:32   作者:H_HX126  
在Vue中实现放大镜效果,主要是为了增强用户体验,让用户在查看商品图片时能更清晰地观察细节,这篇文章主要介绍了vue3图片放大镜效果实现的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下

一、实现滑块跟随鼠标移动效果

1.1 引入vueuse 中的 useMouseInElement 函数

  • 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:蒙版滑块距离目标元素顶部距离
  • 数值计算说明
    • 鼠标可以任意移动,滑块只能在目标元素的盒子里移动
    • 鼠标移动 x 和 y 方向小于 100px 的位置时,蒙版滑块会超出目标盒子,需要把滑块的 left 和 top 值固定为最小值 0,避免滑块继续移动超出目标盒子
    • 鼠标移动到 x 的 300px 或者 y 的 300px 位置时,蒙版滑块也会超出目标盒子,需要把滑块的 left 和 top 值固定为最大值 200,避免滑块继续移动超出目标盒子

1.2.2 经过放大之后的大图显示

  • 这里大图的盒子大小和目标元素盒子大小一样 400px,图片为大图盒子的背景图,背景图片的大小是盒子大小的2倍,相当于图片放大2倍的效果
  • 大图显示的位置与蒙版滑块的位置一样,由于背景图放大了两倍,所以这里要 乘2
  • 大图移动效果与滑块移动位置相反,滑块往左移,大图位置相应往右移,视觉交互更协调,所以背景图的位置要加 - 号,具体效果件见最下方视频
const left = ref(0)
const top = ref(0)
const positionX = ref(0)
const positionY = ref(0)
watch([elementX, elementY, isOutside], () => {
  // 鼠标移出图片区域 不需要计算
  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], () => {
  // 鼠标移出图片区域 不需要计算
  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  将来控制背景图的移动来实现放大的效果查看 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>

1.4 效果展示

总结

到此这篇关于vue3图片放大镜效果实现的文章就介绍到这了,更多相关vue3图片放大镜效果内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:

相关文章

  • vue实现图书管理demo详解

    vue实现图书管理demo详解

    这篇文章主要介绍了vue实现图书管理,分享了图书管理demo用的知识点,以及遇到问题的总结,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-10-10
  • Vue3 表单输入绑定的操作方法

    Vue3 表单输入绑定的操作方法

    本文给大家介绍Vue3 表单输入绑定的相关操作,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2025-10-10
  • 一次VUE项目中遇到XSS攻击的实战记录

    一次VUE项目中遇到XSS攻击的实战记录

    XSS 攻击是页面被注入了恶意的代码,下面这篇文章主要给大家介绍了一次VUE项目中遇到XSS攻击的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2021-12-12
  • 实例讲解Vue.js中router传参

    实例讲解Vue.js中router传参

    本篇文章通过实例给大家分析了Vue.js中router传参的相关知识点,对此有兴趣的朋友参考学习下。
    2018-04-04
  • vue3中的useAttrs和props的区别解析

    vue3中的useAttrs和props的区别解析

    在vue3中, 提供了一个 useAttrs 的方法它接收到的参数一 prop中可以接收到的数据是基本一样的如果我们想自已写一个组件, 把 elementPlus 中的期中一个组件封装一下,这篇文章主要介绍了vue3中的useAttrs和props的区别,需要的朋友可以参考下
    2023-09-09
  • Vue3中的事件总线详解

    Vue3中的事件总线详解

    在Vue3中,推荐使用CompositionAPI和第三方库mitt来实现事件总线,而不是Vue2中使用Vue实例的方式
    2026-01-01
  • vue3+Echarts页面加载不渲染显示空白页面的解决

    vue3+Echarts页面加载不渲染显示空白页面的解决

    这篇文章主要介绍了vue3+Echarts页面加载不渲染显示空白页面的解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-10-10
  • 详解vue中属性执行顺序

    详解vue中属性执行顺序

    这篇文章主要介绍了vue中属性执行顺序,选项的执行顺序是 props -> data -> computed -> watch -> created -> mounted -> methods,具体详细内容本文给大家讲解的非常详细,需要的朋友可以参考下
    2023-09-09
  • vue项目报错:Missing script:"serve"的解决办法

    vue项目报错:Missing script:"serve"的解决办法

    这篇文章主要给大家介绍了关于vue项目报错:Missing script:"serve"的解决办法,"missing script: serve"是一个错误信息,意味着在执行启动脚本时,找不到名为"serve"的脚本,需要的朋友可以参考下
    2023-11-11
  • ElementUI表格中添加表头图标悬浮提示

    ElementUI表格中添加表头图标悬浮提示

    本文主要介绍了ElementUI表格中添加表头图标悬浮提示,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-12-12

最新评论