图片
优质
小牛编辑
134浏览
2023-12-01
jd.chooseImage(OBJECT)
从本地相册选择图片或使用相机拍照。
OBJECT 参数说明:
参数名 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
count | number | 9 | 否 | 最多可以选择的图片张数,默认 9 |
sizeType | Array.<string> | ['original', 'compressed'] | 否 | original 原图,compressed 压缩图,默认二者都有 |
sourceType | Array.<string> | ['album', 'camera'] | 否 | album 从相册选图,camera 使用相机,默认二者都有 |
success | function | 是 | 成功则返回图片的本地文件路径列表 tempFilePaths | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.sizeType 的合法值
值 | 说明 |
---|---|
original | 原图 |
compressed | 压缩图 |
注意: sizeType为枚举值,建议开发者使用时只传一个值。如果传入两个值,优先compressed。
object.sourceType 的合法值
值 | 说明 |
---|---|
album | 从相册选图 |
camera | 使用相机 |
object.success 回调函数
参数
Object res
参数 | 类型 | 说明 |
---|---|---|
tempFilePaths | Array.<string> | 图片的本地文件路径列表(本地路径) |
tempFiles | Array.<Object> | 图片的本地文件列表,每一项是一个 File 对象 |
res.tempFiles 的结构
字段 | 类型 | 说明 |
---|---|---|
path | string | 本地文件路径(本地路径) |
size | number | 本地文件大小,单位: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参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
current | string | 否 | 当前显示图片的链接,不填则默认为 urls 的第一张 |
urls | Array.<string> | 是 | 需要预览的图片链接列表 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
jd.previewImage({
current: '', // 当前显示图片的http链接
urls: [] // 需要预览的图片http链接列表
})
jd.getImageInfo(OBJECT)
获取图片信息。
OBJECT 参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
src | string | 是 | 图片的路径,可以是相对路径,临时文件路径,存储文件路径,网络图片路径 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success 返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
width | number | 图片宽度,单位 px |
height | number | 图片高度,单位 px |
path | string | 返回图片的本地路径 |
orientation | string | 返回图片的方向,有效值见下表 |
type | string | 返回图片的格式 |
orientation 参数说明:
枚举值 | 说明 |
---|---|
up | 默认 |
down | 180 度旋转 |
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 参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
filePath | string | 是 | 图片文件路径,可以是临时文件路径也可以是永久文件路径,不支持网络图片路径 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success 返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
errMsg | string | 调用结果 |
示例代码
jd.saveImageToPhotosAlbum({
success(res) {
console.log(res)
}
})
jd.compressImage(OBJECT)
压缩图片接口,可选压缩质量 (基础库1.10.7开始支持)
OBJECT 参数说明:
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
src | string | 是 | 图片路径,图片的路径,支持本地路径、代码包路径 | |
quality | number | 80 | 否 | 压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对jpg有效) |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success 返回参数说明:
属性 | 类型 | 说明 |
---|---|---|
tempFilePath | string | 压缩后图片的临时文件路径 (本地路径) |
示例代码
jd.compressImage({
src: '',
quality: 80 ,
success(res){
console.log("压缩图片路径为:",res.tempFilePath);
}
})