Skip to main content
Version: 2.x

Taro.chooseMessageFile(option)

从客户端会话选择文件。

参考文档

类型

(option: Option) => Promise<SuccessCallbackResult>

参数

Option

参数类型必填说明
countnumber最多可以选择的文件个数,可以 0~100
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
extensionstring[]根据文件拓展名过滤,仅 type==file 时有效。每一项都不能是空字符串。默认不过滤。
fail(res: CallbackResult) => void接口调用失败的回调函数
success(result: SuccessCallbackResult) => void接口调用成功的回调函数
type"all" | "video" | "image" | "file"所选的文件的类型

SuccessCallbackResult

参数类型说明
tempFilesChooseFile[]返回选择的文件的本地临时文件对象数组
errMsgstring调用结果

ChooseFile

返回选择的文件的本地临时文件对象数组

参数类型说明
namestring选择的文件名称
pathstring本地临时文件路径
sizenumber本地临时文件大小,单位 B
timenumber选择的文件的会话发送时间,Unix时间戳,工具暂不支持此属性
type"video" | "image" | "file"选择的文件类型

selectType

参数说明
all从所有文件选择
video只能选择视频文件
image只能选择图片文件
file可以选择除了图片和视频之外的其它的文件

selectedType

参数说明
video选择了视频文件
image选择了图片文件
file选择了除图片和视频的文件

示例代码

Taro.chooseMessageFile({
count: 10,
type: 'image',
success: function (res) {
// tempFilePath可以作为img标签的src属性显示图片
const tempFilePaths = res.tempFilePaths
}
})

API 支持度

API微信小程序H5React Native
Taro.chooseMessageFile✔️