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	✔️	✔️	✔️	✔️	✔️