Version: next

Taro.chooseMessageFile(option)

从客户端会话选择文件。

参考文档

类型

(option: Option) => Promise<SuccessCallbackResult>

参数

Option

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

SuccessCallbackResult

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

ChooseFile

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

参数类型说明
name
string
选择的文件名称
path
string
本地临时文件路径
size
number
本地临时文件大小,单位 B
time
number
选择的文件的会话发送时间,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✔️