ImagePreview 图片预览

使用指南

ImagePreview和其他组件不同,不是通过HTML结构的方式来使用,而是通过函数调用的方式。使用前需要先引入它。

  1. import { ImagePreview } from 'vant';

代码演示

基础用法

直接传入图片数组,即可展示图片预览

  1. ImagePreview([
  2. 'https://img.yzcdn.cn/1.jpg',
  3. 'https://img.yzcdn.cn/2.jpg'
  4. ]);

传入配置项

通过传入配置对象,可以指定初始图片的位置、监听关闭事件

  1. ImagePreview({
  2. images: [
  3. 'https://img.yzcdn.cn/1.jpg',
  4. 'https://img.yzcdn.cn/2.jpg'
  5. ],
  6. startPosition: 1,
  7. onClose() {
  8. // do something
  9. }
  10. });

异步关闭

通过asyncClose属性可以开启异步关闭,开启后异步关闭后,只能通过实例上的 close 方法关闭图片预览

  1. const instance = ImagePreview({
  2. images: [
  3. 'https://img.yzcdn.cn/1.jpg',
  4. 'https://img.yzcdn.cn/2.jpg'
  5. ],
  6. asyncClose: true
  7. });
  8. setTimeout(() => {
  9. instance.close();
  10. }, 1000);

配置项

参数名说明类型默认值版本
images需要预览的图片 URL 数组Array[]1.1.16
startPosition图片预览起始位置索引Number01.1.16
showIndex是否显示页码Booleantrue1.3.4
showIndicators是否显示轮播指示器Booleanfalse1.3.10
loop是否开启循环播放Booleantrue1.4.4
onClose关闭时的回调函数Function-1.1.16
asyncClose是否开启异步关闭Booleanfalse1.4.8
className自定义类名String | Array | Object-1.5.2
lazyLoad是否开启图片懒加载,须配合 Lazyload 组件使用Booleanfalse1.5.3

onClose 回调参数

参数名说明类型
url当前图片 URLString
index当前图片的索引值Number

原文: https://youzan.github.io/vant/#/zh-CN/image-preview