Taro.chooseImage(option)

从本地相册选择图片或使用相机拍照。

支持情况：

参考文档

类型

(option: Option) => Promise<SuccessCallbackResult>

参数

参数	类型
option	Option

Option

参数	类型	默认值	必填	说明
count	number	9	否	最多可以选择的图片张数 API 支持度: weapp, alipay, swan, tt, h5, rn
sizeType	(keyof sizeType)[]	['original', 'compressed']	否	所选的图片的尺寸 API 支持度: weapp, alipay, swan, tt, rn
sourceType	(keyof sourceType)[]	['album', 'camera']	否	选择图片的来源 API 支持度: weapp, alipay, swan, tt, h5, rn
complete	(res: TaroGeneral.CallbackResult) => void		否	接口调用结束的回调函数（调用成功、失败都会执行）
fail	(res: TaroGeneral.CallbackResult) => void		否	接口调用失败的回调函数
success	(result: SuccessCallbackResult) => void		否	接口调用成功的回调函数
imageId	string		否	用来上传的input元素ID（仅h5端 API 支持度: h5

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

示例代码

Taro.chooseImage({
  count: 1, // 默认9
  sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图，默认二者都有
  sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有，在H5浏览器端支持使用 `user` 和 `environment`分别指定为前后摄像头
  success: function (res) {
    // 返回选定照片的本地文件路径列表，tempFilePath可以作为img标签的src属性显示图片
    var tempFilePaths = res.tempFilePaths
  }
})