微信小程序API 图片

2020-07-28 15:24 更新

压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对jpg有效)。图片路径,图片的路径,支持本地路径、代码包路径图片路径,图片的路径,支持本地路径、代码包路径


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返回参数说明:

参数 类型 说明 最低版本
tempFilePaths StringArray 图片的本地文件路径列表  
tempFiles ObjectArray 图片的本地文件列表,每一项是一个 File 对象 1.2.0

File 对象结构如下:

字段 类型 说明
path String 本地文件路径
size Number 本地文件大小,单位: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参数说明:

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

success返回参数说明:

参数 类型 说明
width Number 图片宽度,单位px
height Number 图片高度 单位px
path String 返回图片的本地路径

示例代码:

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参数说明:

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

success返回参数说明:

参数名 类型 说明
errMsg String 调用结果

示例代码:

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

wx.compressImage(Object object)


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

压缩图片接口,可选压缩质量

参数

Object参数说明:

 属性  类型  默认值  必填  说明
 src  string
是  图片路径,图片的路径,支持本地路径、代码包路径
 quality  number 80 压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对jpg有效)。
 success  function   接口调用成功的回调函数
 fail  function   接口调用失败的回调函数
 complete  function   接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

属性 类型 说明
tempFilePath string 压缩后图片的临时文件路径 (本地路径)

示例代码

wx.compressImage({
  src: '', // 图片路径
  quality: 80 // 压缩质量
})


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号

意见反馈
返回顶部