图片

优质
小牛编辑
134浏览
2023-12-01

jd.chooseImage(OBJECT)

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

OBJECT 参数说明:

参数名类型默认值必填说明
countnumber9最多可以选择的图片张数,默认 9
sizeTypeArray.<string>['original', 'compressed']original 原图,compressed 压缩图,默认二者都有
sourceTypeArray.<string>['album', 'camera']album 从相册选图,camera 使用相机,默认二者都有
successfunction成功则返回图片的本地文件路径列表 tempFilePaths
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.sizeType 的合法值

说明
original原图
compressed压缩图

注意: sizeType为枚举值,建议开发者使用时只传一个值。如果传入两个值,优先compressed。

object.sourceType 的合法值

说明
album从相册选图
camera使用相机

object.success 回调函数

参数
Object res
参数类型说明
tempFilePathsArray.<string>图片的本地文件路径列表(本地路径)
tempFilesArray.<Object>图片的本地文件列表,每一项是一个 File 对象

res.tempFiles 的结构

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

示例代码

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

jd.previewImage(OBJECT)

预览图片。

OBJECT参数说明:

参数名类型必填说明
currentstring当前显示图片的链接,不填则默认为 urls 的第一张
urlsArray.<string>需要预览的图片链接列表
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

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

jd.getImageInfo(OBJECT)

获取图片信息。

OBJECT 参数说明:

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

success 返回参数说明:

参数类型说明
widthnumber图片宽度,单位 px
heightnumber图片高度,单位 px
pathstring返回图片的本地路径
orientationstring返回图片的方向,有效值见下表
typestring返回图片的格式

orientation 参数说明:

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

示例代码

jd.getImageInfo({
  src: 'images/name.jpg',
  success: function (res) {
    console.log(res)
  }
})

jd.chooseImage({
  success: function (res) {
    jd.getImageInfo({
      src: res.tempFilePaths[0],
      success: function (res) {
        console.log(res.width)
      }
    })
  }
})

jd.saveImageToPhotosAlbum(OBJECT)

OBJECT 参数说明:

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

success 返回参数说明:

参数类型说明
errMsgstring调用结果

示例代码

jd.saveImageToPhotosAlbum({
    success(res) {
      console.log(res)
    }
})

jd.compressImage(OBJECT)

压缩图片接口,可选压缩质量 (基础库1.10.7开始支持)

OBJECT 参数说明:

属性类型默认值必填说明
srcstring图片路径,图片的路径,支持本地路径、代码包路径
qualitynumber80压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对jpg有效)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明:

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

示例代码

jd.compressImage({
  src: '',
  quality: 80 ,
  success(res){
    console.log("压缩图片路径为:",res.tempFilePath);
    }
  })