微信小程序开发文档 微信小程序API 图片·从客户端会话选择文件

2024-02-25 开发教程 微信小程序开发文档 匿名 4

wx.chooseMessageFile(Object object)

基础库 2.5.0 开始支持,低版本需做兼容处理。

从客户端会话选择文件。

参数

Object object

属性类型默认值必填说明最低版本
countnumber最多可以选择的文件个数,可以 0~100
typestring'all'所选的文件的类型
extensionArray.<string>根据文件拓展名过滤,仅 type==file 时有效。每一项都不能是空字符串。默认不过滤。2.6.0
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.type 的合法值

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

object.success 回调函数

参数
Object res
属性类型说明
tempFilesArray.<Object>返回选择的文件的本地临时文件对象数组

res.tempFiles 的结构

属性类型说明
pathstring本地临时文件路径 (本地路径)
sizenumber本地临时文件大小,单位 B
namestring选择的文件名称
typestring选择的文件类型
timenumber选择的文件的会话发送时间,Unix时间戳,工具暂不支持此属性

type 的合法值

说明最低版本
video选择了视频文件
image选择了图片文件
file选择了除图片和视频的文件
wx.chooseMessageFile({
count: 10,
type: 'image',
success (res) {
// tempFilePath可以作为img标签的src属性显示图片
const tempFilePaths = res.tempFiles
}
})