微信小程序API 图片

2016-09-24

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) {
    }
})