Version: 2.2.1

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原图
compressedcompressed

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微信小程序H5React 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微信小程序百度小程序支付宝小程序H5React Native
Taro.chooseImage✔️✔️✔️✔️✔️