# uni.previewImage(options)

预览图片

# # 参数

名称 类型 必填 描述
options PreviewImageOptions -

# # PreviewImageOptions

名称 类型 必填 描述
count string 当前显示图片的链接,不填则默认为 urls 的第一张
current any current 为当前显示图片的链接/索引值,不填或填写的值无效则为 urls 的第一张。App平台在 1.9.5至1.9.8之间,current为必填。不填会报错
urls Array<string> 需要预览的图片链接列表
indicator string 图片指示器样式 - default: 底部圆点指示器 - number: 顶部数字指示器 - none: 不显示指示器
loop boolean 是否可循环预览
longPressActions LongPressActionsOptions 长按图片显示操作菜单,如不填默认为保存相册,1.9.5 起支持。
success (PreviewImageSuccessCallback) => void 接口调用成功的回调函数
fail (UniError) => void 接口调用失败的回调函数
complete (any) => void 接口调用结束的回调函数(调用成功、失败都会执行)
# # LongPressActionsOptions
名称 类型 必填 描述
itemList Array<string> 按钮的文字数组
itemColor string 按钮的文字颜色,字符串格式,默认为"#000000"
success (LongPressActionsSuccessData) => void 接口调用成功的回调函数
fail (any) => void 接口调用失败的回调函数
complete (any) => void 接口调用结束的回调函数(调用成功、失败都会执行)
# # LongPressActionsSuccessData
名称 类型 必填 描述
tapIndex number 接口调用失败的回调函数
index number 接口调用结束的回调函数(调用成功、失败都会执行)
# # PreviewImageSuccessCallback
名称 类型 必填 描述
errSubject string -
errMsg string -

# # 兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 - - -

# # 参见

previewImage

# # 通用类型

# # GeneralCallbackResult

名称 类型 必填 描述
errMsg string 错误信息