title: Taro.chooseImage(option)

sidebar_label: chooseImage

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

支持情况：chooseImage - 图1 chooseImage - 图2 chooseImage - 图3 chooseImage - 图4 chooseImage - 图5

参考文档

类型

  1. (option: Option) => Promise<SuccessCallbackResult>

参数

参数 类型
option Option

Option

参数 类型 必填 说明
complete (res: TaroGeneral.CallbackResult) => void 否 接口调用结束的回调函数（调用成功、失败都会执行）
count number 否 最多可以选择的图片张数
fail (res: TaroGeneral.CallbackResult) => void 否 接口调用失败的回调函数
sizeType (keyof sizeType)[] 否 所选的图片的尺寸
sourceType (keyof sourceType)[] 否 选择图片的来源
success (result: SuccessCallbackResult) => void 否 接口调用成功的回调函数
imageId string 否 用来上传的input元素ID（仅h5端）@supported 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

示例代码

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