# Upload 上传

通过点击或者拖拽上传文件

# 代码演示

# API

# Attribute

参数	说明	类型	可选值	默认值
action	必选参数，上传的地址	String	—	—
headers	设置上传的请求头部	Object	—	—
multiple	是否支持多选文件	Boolean	—	—
data	上传时附带的额外参数	Object	—	—
name	上传的文件字段名	String	—	file
with-credentials	支持发送 cookie 凭证信息	Boolean	—	false
show-file-list	是否显示已上传文件列表	Boolean	—	true
drag	是否启用拖拽上传	Boolean	—	false
accept	接受上传的文件类型（thumbnail-mode 模式下此参数无效）	String	—	—
on-preview	点击文件列表中已上传的文件时的钩子	Function(file)	—	—
on-remove	文件列表移除文件时的钩子	Function(file, fileList)	—	—
on-success	文件上传成功时的钩子	Function(response, file, fileList)	—	—
on-error	文件上传失败时的钩子	Function(err, file, fileList)	—	—
on-progress	文件上传时的钩子	Function(event, file, fileList)	—	—
on-change	文件状态改变时的钩子，添加文件、上传成功和上传失败时都会被调用	Function(file, fileList)	—	—
before-upload	上传文件之前的钩子，参数为上传的文件，若返回 false 或者返回 Promise 且被 reject，则停止上传。	Function(file)	—	—
before-remove	删除文件之前的钩子，参数为上传的文件和文件列表，若返回 false 或者返回 Promise 且被 reject，则停止删除。	Function(file, fileList)	—	—
list-type	文件列表的类型	String	'text' | 'picture' | 'picture-card'	'text'
auto-upload	是否在选取文件后立即进行上传	Boolean	—	true
file-list	上传的文件列表, 例如: [{name: 'food.jpg', url: 'https://xxx.cdn.com/xxx.jpg'}]	Array	—	[]
http-request	覆盖默认的上传行为，可以自定义上传的实现	Function	—	—
disabled	是否禁用	Boolean	—	false
limit	最大允许上传个数	Number	—	—
on-exceed	文件超出个数限制时的钩子	Function(files, fileList)	—	—

# Slot

name	说明
trigger	触发文件选择框的内容
tip	提示说明文字

# Methods

方法名	说明	参数
clearFiles	清空已上传的文件列表（该方法不支持在 before-upload 中调用）	—
abort	取消上传请求	（ file: fileList 中的 file 对象 ）
submit	手动上传文件列表	—