vue+vant使用图片预览功能ImagePreview的问题

本文介绍了解决Vue中使用vant或viewerjs图片预览组件在路由变化时仍显示的问题,提供了两种解决方案:一是利用Vue的beforeRouteLeave钩子关闭预览;二是使用viewerjs插件,它提供了更丰富的功能和更好的钩子控制。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

如果您搜到这篇文章的话,那员外估计您遇到跟我一样的问题了,即在打开图片预览功能后,如果不关闭预览的图片,同时改变路由的话,会发现即使路由改变了,预览的图片还在文档的最顶层显示,如图: 着实让员外百思不其解,在调用vant 的 ImagePreview )图片预览组件中,没有html,有的只是引入ImagePreview 和js的调用。在这种情况下,员外是想自己添加任何方法都没法实现的,同时想在离开路由时的beforeRouteLeave 钩子中关闭这个 ImagePreview 也实现不了,因为根本就拿他没有一点办法。同时可以看到,这个图片预览的 html 是挂载在 window 上面的,实在是太 难为初学者了。

#第一种解决办法 

 后来多方请教,终于请到一位大佬,为员外指点迷津。 1. 首先需要定义两个实际变量,instance_beforeinstance_after,之所以是两个是因为在这个页面有两个 tab 里面的图片需要预览; 2. 然后把两个 ImagePreview[] 分别赋值给instance_beforeinstance_after,测试一下图片是否能正常打开关闭,结果当然是可以的; 3. 然后在 beforeRouteLeave 钩子中调用 close() 方法关闭预览遮罩。 其实这个问题主要还是单页只有一个vue实例,然后在调用 ImagePreview[] 的时候页面在返回上一个路由或前进到下一个路由,其产生的DOM节点还存在页面中,所以要做的是在当前路由跳转的时候及时移除或者隐藏这个DOM节点。 代码: 

import {ImagePreview} from 'vant';
export default {
        data() {
            return {
                active_:'',    //切换 tab 所对应的状态数字
                instance_before:'',
                instance_after:'',
            }
        },
        //在路由离开的时候,关闭预览的图片
        beforeRouteLeave(to,from,next){
            if(this.active_ == 0){
                this.instance_before.close();
            }else{
                this.instance_after.close();
            }
            next();
        },
        methods: {
            //查看图片
            show_before_img(){
                this.instance_before = ImagePreview({
                    images: [this.warsher_brfore],
                });
            },
            show_after_img(){
                this.instance_after = ImagePreview({
                    images: [this.warsher_after],
                });
            },
        }
}复制代码

 #第二种解决办法 

 这个办法就与 vant 无关了,员外使用的是 viewerjs 插件,这是一款专门针对图片预览打造的插件,功能要比 vant 自带的全得多,而且自带很多钩子功能,如果您需求比较复杂的话,那使用起来真的是太方便了。 ##使用方法: 安装依赖 npm i viewerjs -S 在 main.js中引入并设置好各种参数,当然如果您对效果要求不高,可以不设,许多默认的也够您使用了。里面有许多不用的功能,员外都 false 了。 

import Viewer from 'v-viewer'
import 'viewerjs/dist/viewer.css'

Viewer.setDefaults({
  'inline':false,
  'button':true, //右上角按钮
  "navbar": false, //底部缩略图
  "title": false, //当前图片标题
  "toolbar": false, //底部工具栏
  "tooltip": false, //显示缩放百分比
  "movable": true, //是否可以移动
  "zoomable": true, //是否可以缩放
  "rotatable": true, //是否可旋转
  "scalable": true, //是否可翻转
  "transition": true, //使用 CSS3 过度
  "fullscreen": true, //播放时是否全屏
  "keyboard": false, //是否支持键盘
  "url": "data-source",
  ready: function (e) {
    console.log(e.type,'组件以初始化');
  },
  show: function (e) {
    console.log(e.type,'图片显示开始');
  },
  shown: function (e) {
    console.log(e.type,'图片显示结束');
  },
  hide: function (e) {
    console.log(e.type,'图片隐藏完成');
  },
  hidden: function (e) {
    console.log(e.type,'图片隐藏结束');
  },
  view: function (e) {
    console.log(e.type,'视图开始');
  },
  viewed: function (e) {
    console.log(e.type,'视图结束');
  },
  zoom: function (e) {
    console.log(e.type,'图片缩放开始');
  },
  zoomed: function (e) {
    console.log(e.type,'图片缩放结束');
  }
});复制代码

 设置好之后即可直接使用了。这里有一个小坑,员外在网上查了挺多 demo的,大多数的教程里面都是教您如何预览多张图片,但是员外的需要是只需要预览一张,所以在使用的时候也是绕了一点弯子的。 在 .vue 组件中使用: 首先员外先介绍一下多图片的使用方法: html中: 

<template>
  <div id="index">
    <ul>
      <li v-for="(item, index) in imgArr" :key="index">
        <img :src="item" />
      </li>
    </ul>
  </div>
</template>
```
js
```
data() {
        return {
            imgArr: [
                 "图片地址",
                 "图片地址",
                 "图片地址",
                 "图片地址",
                 "图片地址",
            ]
        };
    },
    mounted() {
        //调用就是这么简单,直接 new 一个新 Viewer 对象即可
        const viewer = new Viewer(document.getElementById("index"), {});
    }复制代码

 单个图片的使用方法其实跟上面的例子几乎一样: 

//html
<div class="img-box">
    <img :src="warsher_before_img" alt="" id="warsher_before_img">
</div>
//js
mounted() {
  //调用就是这么简单,直接 new 一个新 Viewer 对象即可
  const viewer = new Viewer(document.getElementById('warsher_before_img'))
}复制代码

 切记,千万不要多事在事件中调用上面 mounted 中的方法,会导致在第一次触发事件的时候,Viewer 实例才刚刚生成,但是不会被调用,然后在第二次触发事件的时候,才会生效。别问我怎么知道的。。。


转载于:https://juejin.im/post/5cbb28c4f265da0368145904

### 实现图片预览功能Vue 2 中使用 Vant 2 的 `ImagePreview` 组件可以方便地实现图片预览功能。以下是具体的方法: #### 安装依赖 为了使用 Vant 2,首先需要通过 npm 或 yarn 安装相应的包。 ```bash npm install vant@latest-v2 ``` #### 引入组件 对于按需加载的方式,推荐使用 babel-plugin-import 插件来减少打包体积。如果选择手动引入,则可以在 main.js 文件里全局注册所需组件。 ```javascript import { ImagePreview } from 'vant'; Vue.use(ImagePreview); ``` 也可以单独导入特定的模块并挂载到原型链上以便于在整个应用范围内调用。 #### 使用模板语法编写 HTML 结构 下面是在 `<template>` 部分定义用于触发预览行为的元素结构的例子。 ```html <template> <div class="image-preview-container"> <!-- 图片列表 --> <ul class="images-list"> <li v-for="(item, idx) of imageUrls" :key="idx"> <img :src="item" @click="showImg(idx)" alt="" /> </li> </ul> </div> </template> ``` 这里展示了一个简单的无序列表 (`<ul>`) 来容纳一系列带有索引键值 (`:key`) 和点击事件监听器 (@click) 的图像项(`<img />`) 。当用户单击某一张照片时会触发 showImg 方法传递当前项目的索引位置作为参数给它处理[^2]。 #### 编写 JavaScript 行为逻辑 接下来是关于如何响应用户的交互动作——即打开大图查看模式的具体做法。 ```javascript export default { data() { return { imageUrls: [ '/path/to/image1.jpg', '/path/to/image2.png' ] }; }, methods: { showImg(index) { const options = { images: this.imageUrls, startPosition: index, onClose: () => console.log('preview closed') }; ImagePreview(options); // 调用 Vant 提供的静态方法启动预览 } } }; ``` 这段代码展示了怎样利用 `data()` 函数初始化一组待显示的照片链接数组,并且定义了名为 `showImg` 的成员函数负责接收来自视图层传来的选中项下标进而构建配置对象并通过 `ImagePreview` API 展示对应的大尺寸版本[^3]。 针对 iOS 设备可能出现的问题,可以通过设置 `closeOnPopstate=true` 参数确保页面回退时不干扰弹窗状态;另外注意检查是否有其他插件冲突影响到了正常的生命周期管理。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值