跳到主要内容

ImagePreview 图片预览 ​

WebH5

图片预览。全屏遮罩查看图片,支持多图切换、滚轮缩放(0.5x-3x)、双击切换 1x/2x、Esc 关闭;可组件式使用也可 showImagePreview 服务式调起。

何时使用 ​

点击图片后需要全屏查看、缩放或在多图间切换。

何时不使用 ​

单张图简单放大可用 Image 的 preview;图文混排详情用 Dialog。

Props ​

名称类型默认值说明
modelValuebooleanfalse显隐(v-model)
imagesstring[]"-"图片地址列表(必填)
startIndexnumber0初始显示第几张(从 0 开始)

Events ​

名称载荷说明
update:modelValueboolean显隐变化时触发
close-关闭时触发(遮罩点击 / × / Esc)
changeindex: number切换图片时触发,参数为新索引

示例 ​

组件式(多图切换) ​

示例加载中…

配合 Image 组件 ​

示例加载中…

单图预览 ​

示例加载中…

指定初始索引 ​

示例加载中…

事件监听 ​

示例加载中…

业务场景:商品详情图集 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 ImagePreview 文档(含手机预览)。