图片
qh.chooseImage
解释:从本地选择图片。
方法参数:Object object
object
参数说明:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
count | Number | 否 | - | 最多可以选择的图片张数,默认 9。 |
sizeType | - | 暂不支持 | ||
success | Function | 否 | - | 成功则返回图片的本地文件路径列表 tempFilePaths。 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
说明: 文件的临时路径,如需持久保存,需在主动调用 qh.saveFile。
success返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
tempFilePaths | Array.<string> | 图片的本地文件路径列表 。 |
tempFiles | Array.<object> | 图片的本地文件列表,每一项是一个 File 对象。 |
tempFiles 对象结构如下:
字段 | 类型 | 说明 |
---|---|---|
path | String | 本地文件路径 |
size | Number | 本地文件大小(单位:B) |
示例:
- 在 js 文件中
qh.chooseImage({
count: 1,
success: function (res) {
// 成功则返回图片的本地文件路径列表 tempFilePaths
console.log(res.tempFilePaths);
// 文件列表对象
console.log(res.tempFiles);
},
fail: function (errMsg) {
console.log('错误信息:' + errMsg);
}
});
qh.getImageInfo
解释:获取图片信息
方法参数:Object object
object
参数说明:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
src | String | 是 | - | 图片的路径,可以是相对路径、临时文件路径或存储文件路径、网络图片。 |
success | Function | 否 | - | 接口调用成功的回调函数 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
width | Number | 图片宽度(单位:px) |
height | Number | 图片高度(单位:px) |
path | String | 返回图片的本地路径 |
orientation | String | 返回图片的方向:· up:默认不变;·down:180度旋转;·left:逆时针90度旋转;·right:顺时针90度旋转;· up-mirrored:镜像翻转;· down-mirrored:镜像180旋转;· left-mirrored:逆时针90度镜像旋转;· right-mirrored:顺时针90度镜像旋转。 |
type | String | 返回图片的格式 |
示例:
Page({
getImageInfo() {
qh.getImageInfo({
src: 'http://p8.qhimg.com/t0107f8414d4ec47d70.png',
success: function (res) {
console.log(res);
},
fail: function (err) {
console.log(err);
}
});
}
});
qh.saveImageToPhotosAlbum
解释: 保存图片到系统目录中我的图片。
方法参数:Object object
object
参数说明:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
filePath | String | 是 | - | 图片文件路径,可以是临时文件路径、网络图片路径。 |
success | Function | 否 | - | 接口调用成功的回调函数 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例:
Page({
saveImageToPhotosAlbum() {
qh.chooseImage({
count: 1,
success: function (res) {
qh.saveImageToPhotosAlbum({
filePath: res.tempFilePaths[0],
success: function (res) {
console.log('保存成功');
},
fail: function (err) {
console.log('保存失败');
}
});
},
fail: function (err) {
console.log(err);
}
});
}
});
qh.chooseMessageFile
解释: 本地选择文件。
方法参数:Object object
object
参数说明:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
count | Number | 否 | - | 最多可以选择的文件数,默认 9。 |
type | String | 否 | 'all' | 所选的文件的类型。 |
extension | Array. | 否 | 根据文件拓展名过滤,仅type==file时有效,默认不过滤。 | |
success | Function | 否 | - | 接口调用成功的回调函数。 |
fail | Function | 否 | - | 接口调用失败的回调函数 |
complete | Function | 否 | - | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
tempFiles | Array.<object> | 本地文件列表,每一项是一个 File 对象。 |
tempFiles 对象结构如下:
字段 | 类型 | 说明 |
---|---|---|
path | String | 本地临时文件路径 |
name | String | 选择的文件名称 |
size | Number | 本地文件大小(单位:B) |