更新记录

1.0.0（2026-06-12）

初版，使用时建议在非超大图的情况下改为使用官方的API

平台兼容性

uni-app(5.07)

uni-app x(5.07)

uts-imagePreview API 调用说明

导入

import { previewImage } from '@/uni_modules/uts-imagePreview'

调用

previewImage({
  urls: ['https://example.com/image.jpg'],
  current: 0,               // 默认显示第几张，从0开始
  maxZoom: 5,               // 最大缩放倍数
  tileSize: 1024,           // 切片尺寸（超大图模式）
  largeImageThreshold: 2048,// 超过此尺寸启用切片
  backgroundColor: '#000000',
  onClose: () => {},
  onChange: (index: number) => {}
})

返回值

const viewer = previewImage({ urls: [...] })
viewer?.close()  // 主动关闭预览

返回 ImagePreviewResult 对象，包含 close() 方法。