uni.previewImage(options)
预览图片
参数
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 | 是 | 错误信息 |