跳到主要内容
版本:3.x

Taro.chooseImage(option)

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

支持情况:

参考文档

类型

(option: Option) => Promise<SuccessCallbackResult>

参数

参数类型
optionOption

Option

参数类型默认值必填说明
countnumber9最多可以选择的图片张数
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接口调用成功的回调函数
imageIdstring用来上传的input元素ID(仅h5端
API 支持度: h5

sizeType

图片的尺寸

参数说明
original原图
compressedcompressed

sourceType

图片的来源

参数说明
album从相册选图
camera使用相机
user使用前置摄像头(仅H5纯浏览器使用)
environment使用后置摄像头(仅H5纯浏览器)

SuccessCallbackResult

参数类型说明
tempFilePathsstring[]图片的本地临时文件路径列表
tempFilesImageFile[]图片的本地临时文件列表
errMsgstring调用结果

ImageFile

图片的本地临时文件列表

参数类型必填说明
pathstring本地临时文件路径
sizenumber本地临时文件大小,单位 B
typestring文件的 MIME 类型
API 支持度: h5
originalFileObjFile原始的浏览器 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
}
})