图片 - chooseImage - 《Taro v3.0 API文档》

类型
参数
示例代码
API 支持度

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

参考文档

类型

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