Version: next
Taro.chooseImage(option)
从本地相册选择图片或使用相机拍照。
类型
(option: Option) => Promise<SuccessCallbackResult>
参数
Option
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| complete | (res: CallbackResult) => void | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
| count | number | 否 | 最多可以选择的图片张数 |
| fail | (res: CallbackResult) => void | 否 | 接口调用失败的回调函数 |
| sizeType | ("original" | "compressed")[] | 否 | 所选的图片的尺寸 |
| sourceType | ("album" | "camera" | "user" | "environment")[] | 否 | 选择图片的来源 |
| success | (result: SuccessCallbackResult) => void | 否 | 接口调用成功的回调函数 |
sizeType
图片的尺寸
| 参数 | 说明 |
|---|---|
| original | 原图 |
| compressed | compressed |
sourceType
图片的来源
| 参数 | 说明 |
|---|---|
| album | 从相册选图 |
| camera | 使用相机 |
| user | 使用前置摄像头(仅H5纯浏览器使用) |
| environment | 使用后置摄像头(仅H5纯浏览器) |
SuccessCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| tempFilePaths | string[] | 图片的本地临时文件路径列表 |
| tempFiles | ImageFile[] | 图片的本地临时文件列表 |
| errMsg | string | 调用结果 |
ImageFile
图片的本地临时文件列表
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| path | string | 是 | 本地临时文件路径 |
| size | number | 是 | 本地临时文件大小，单位 B |
| type | string | 否 | 文件的 MIME 类型 API 支持度: h5 |
| originalFileObj | File | 否 | 原始的浏览器 File 对象 API 支持度: h5 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| ImageFile.type | ✔️ | ||
| ImageFile.originalFileObj | ✔️ |
示例代码
Taro.chooseImage({
count: 1, // 默认9
sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图，默认二者都有
sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有，在H5浏览器端支持使用 `user` 和 `environment`分别指定为前后摄像头
success: function (res) {
// 返回选定照片的本地文件路径列表，tempFilePath可以作为img标签的src属性显示图片
var tempFilePaths = res.tempFilePaths
}
})
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | H5 | React Native |
|---|---|---|---|---|---|
| Taro.chooseImage | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |