my.previewimage(object object)
支小宝客户端 支持
安诊儿客户端 支持
主体： 企业支付宝小程序 、 个人支付宝小程序
预览图片。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
|---|---|---|---|---|---|
| enablesavephoto | boolean | false | 否 | 基础库: 1.0/2.4.4 |
是否支持长按下载图片 |
| enableshowphotodownload | boolean | false | 否 | 基础库: 1.0/2.4.4 |
是否在右下角显示下载入口 |
| urls | array |
- | 是 | - | 需要预览的图片链接列表 |
| current | number | 0 | 否 | - | 当前显示图片的索引值 |
| success | function | - | 否 | - | 调用成功的回调函数 |
| fail | function | - | 否 | - | 调用失败的回调函数 |
| complete | function | - | 否 | - | 调用结束的回调函数（调用成功、失败都会执行） |
fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。
| 错误码 | 错误消息 | 凯发app官方网站的解决方案 |
|---|---|---|
| 2 | 接口参数无效 | 检查入参是否正确。 |
| 只支持 http/https 图片链接 | 确保图片 urls 为 https/http 协议的图片地址。 |
|
| 8 | 图片加载失败 | 将待预览图片的宽高限制在 5000px 以内 |
代码示例
扫码体验
my.previewimage(object object)
success 回调函数参数
fail 回调函数参数
my.previewimage ({
current: 2, // 默认显示第三张图片
urls: [
'https://img.alicdn.com/tps/tb1sxgyifxxxxc5xpxxxxxxxxxx.jpg',
'https://img.alicdn.com/tps/tb1pfg4ifxxxxc6xxxxxxxxxxxx.jpg',
'https://img.alicdn.com/tps/tb1h9xxifxxxxbkxxxxxxxxxxxx.jpg',
],
enablesavephoto: true, // 长按下载
enableshowphotodownload: true, // 右下角显示下载入口
success: function (res) {
console.log (res);
},
fail: function (err) {
console.log (err);
},
});
{ "success": true }
{
"error": 2,
"errormessage": "接口参数无效"
}
-
bug支付宝客户端 10.5.26 版本之前不支持预览 gif 动图。
-
bug
部分线上图片地址可能会预览失败，可以配合 my.downloadfile 把图片下载到本地再进行预览。示例代码如下：
my.downloadfile({ url: "https://img.alicdn.com/tfs/tb1x669sxxxxxbdafxxxxxxxxxx-520-280.jpg", success(res) { console.log("downloadfile - success", res); my.previewimage({ urls: [res.tempfilepath], success(res) { console.log("previewimage-success", res); }, fail(err) { console.log("previewimage-fail", err); }, }); }, fail(err) { console.log("downloadfile - fail", err); }, }); -
bug
安卓客户端为了防止内存溢出，限制了图片宽高不得超过 5000px。
10.5.26 版本之前，超过会弹 toast 提示“下载原图失败”，并且接口不会报错；10.5.26 版本之后，接口会报错，错误码为 8。预览图片请注意图片宽高大小。