微信小程序开发 专题
专题目录
您的位置:微信小程序开发 > 微信小程序开发专题 > 微信小程序API 图片
微信小程序API 图片
作者:--    发布时间:2019-11-20

wx.chooseimage(object)


从本地相册选择图片或使用相机拍照。

object参数说明:

参数 类型 必填 说明
count number 最多可以选择的图片张数,默认9
sizetype stringarray "original"原图,"compressed"压缩图,默认二者都有
sourcetype stringarray "album"从相册选图,"camera"使用相机,默认二者都由
success function 成功则返回图片的本地文件路径列表tempfilepaths
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

注:文件的临时路径,在小程序本次启动期间可以正常使用,如需持久保存,需在主动调用 wx.savefile,在小程序下次启动时才能访问得到。

success返回参数说明:

参数类型说明最低版本
tempfilepathsstringarray图片的本地文件路径列表 
tempfilesobjectarray图片的本地文件列表,每一项是一个 file 对象1.2.0

file 对象结构如下:

字段类型说明
pathstring本地文件路径
sizenumber本地文件大小,单位:b

示例代码:

wx.chooseimage({
    count: 1, // 默认9
    sizetype: ['original', 'compressed'], // 可以指定是原图还是压缩图,默认二者都有
    sourcetype: ['album', 'camera'], // 可以指定来源是相册还是相机,默认二者都有
    success: function (res) {
          // 返回选定照片的本地文件路径列表,tempfilepath可以作为img标签的src属性显示图片
        var tempfilepaths = res.tempfilepaths
    }
})

wx.previewimage(object)


​ 预览图片。

object参数说明:

参数 类型 必填 说明
current string 当前显示图片的链接,不填则默认为urls的第一张
urls stringarray 需要预览的图片链接列表
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:

wx.previewimage({
    current: '', // 当前显示图片的http链接
    urls: [] // 需要预览的图片http链接列表
})

wx.getimageinfo(object)

获取图片信息。

object参数说明:

参数类型必填说明
srcstring图片的路径,可以是相对路径,临时文件路径,存储文件路径,网络图片路径
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数类型说明
widthnumber图片宽度,单位px
heightnumber图片高度 单位px
pathstring返回图片的本地路径

示例代码:

wx.getimageinfo({
  src: 'images/a.jpg',
  success: function (res) {
    console.log(res.width)
    console.log(res.height)
  }
})

wx.chooseimage({
  success: function (res) {
    wx.getimageinfo({
      src: res.tempfilepaths[0],
      success: function (res) {
        console.log(res.width)
        console.log(res.height)
      }
    })
  }
})


wx.saveimagetophotosalbum(object)

基础库 1.2.0 开始支持,低版本需做兼容处理

保存图片到系统相册,需要用户授权(scope.writephotosalbum),详见 用户授权

object参数说明:

参数名类型必填说明
filepathstring图片文件路径,可以是临时文件路径也可以是永久文件路径,不支持网络图片路径
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数名类型说明
errmsgstring调用结果

示例代码:

wx.saveimagetophotosalbum({
    success(res) {
    }
})

网站声明:
本站部分内容来自网络,如您发现本站内容
侵害到您的利益,请联系本站管理员处理。
联系站长
373515719@qq.com
关于本站:
编程参考手册