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 | 是 | 错误信息 |