微信小程序开发

微信小程序开发教程--媒体组件-图片wx.chooseImage(OBJECT)

2018/7/28 23:34:33 人评论 次浏览

wx.chooseImage(OBJECT)

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

OBJECT参数说明:

参数类型必填说明
countNumber最多可以选择的图片张数,默认9
sizeTypeStringArrayoriginal 原图,compressed 压缩图,默认二者都有
sourceTypeStringArrayalbum 从相册选图,camera 使用相机,默认二者都有
successFunction成功则返回图片的本地文件路径列表 tempFilePaths
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

注:文件的临时路径,在小程序本次启动期间可以正常使用,如需持久保存,需在主动调用 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参数说明:

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

示例代码:

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

wx.getImageInfo(OBJECT)

获取图片信息,倘若为网络图片,需先配置download域名才能生效。

OBJECT参数说明:

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

success返回参数说明:

参数类型说明最低版本
widthNumber图片宽度,单位px
heightNumber图片高度,单位px
pathString返回图片的本地路径
orientationString返回图片的方向,有效值见下表1.9.90
typeString返回图片的格式1.9.90

orientation参数说明:

枚举值说明
up默认
down180度旋转
left逆时针旋转90度
right顺时针旋转90度
up-mirrored同up,但水平翻转
down-mirrored同down,但水平翻转
left-mirrored同left,但垂直翻转
right-mirrored同right,但垂直翻转

示例代码:

代码片段

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