文件上传

更新时间:2025-01-24 07:41:28

简介

文件上传组件是用于将信息上传到服务器的魔笔基础组件。

image

配置项

分类

配置

示例

说明

分类

配置

示例

说明

内容

标题

image

组件标题文本

图标

image

组件图标

文件类型

image

文件类型,多个用逗号隔开,如 .xls,.xlsx 可限制为 Excel 上传

最大数量

image

多文件上传时,允许上传的最大文件数

选择器类型

image

选择器类型,可选项:单文件、多文件、文件夹

数据转化

image

数据转化,自动解析文件内容

展示上传列表

image

是否展示上传列表

标签

image

标签,详情参见表单通用属性

交互

隐藏

image

隐藏,详情参见通用属性

隐藏时保留布局

image

隐藏时保留布局,详情参见通用属性

动作

image

动作,默认行为需要自行指定上传地址,阿里云 OSS 模式下仅支持单文件,可选项:默认、上传至系统文件存储、上传至阿里云 OSS

系统路径

image

上传至系统文件存储时,选择上传的目标系统路径

上传方法

image

上传方法,可选项:POST、GET、PUT

上传地址

image

默认动作下,设置上传地址

OSS凭证操作

image

上传资源至阿里云 OSS时显示此项,下拉选项为已创建的OSS集成操作

上传大小限制

image

上传文件的大小限制

禁用

image

禁用组件,禁用后不可交互

校验

image

校验,详情参见表单通用属性

样式

外边距

image

外边距,详情参见通用属性

圆形样式

image

外观是否显示为圆形

字体大小

image

标题文字大小

属性与方法

名称

类型

示例

说明

名称

类型

示例

说明

value

array

upload.value

当前文件上传组件的已选文件路径列表

mode

string

upload.mode

只读,当前文件上传组件的模式

parsedValues

array

upload.parsedValues

只读,当前文件上传组件的已选文件转化后的文件列表

action

string

upload.action

默认上传动作,值为以下几种:default(默认)、system(上传至系统文件存储)、aliyun-oss(上传至阿里云 OSS)

disableUpload

boolean

upload.disableUpload

是否为阻止上传状态

extraHeader

object

upload.extraHeader

额外上传的请求头

extraData

object

upload.extraData

额外上传的数据

method

string

upload.method

上传方法

uploadProgress

number

upload.uploadProgress

上传进度

validationMessage

string

upload.validationMessage

校验结果信息

validationStatus

boolean

upload.validationStatus

是否通过校验

clearValue

func

upload.clearValue()

清除组件 value 值

setValue

func

upload.setValue(null)

设置当前文件上传组件的已选文件路径列表

setDisableUpload

func

upload.setDisableUpload(true)

设置阻止上传的状态位

setExtraHeader

func

upload.setExtraHeader({Connection: keep-alive})

设置额外上传头

setExtraData

func

upload.setExtraData({data:100})

设置额外上传数据

setAction

func

upload.setAction('system')

设置默认上传路径

setMethod

func

upload.setMethod('post')

设置上传方法

clearValidate

func

upload.clearValidate()

清除验证状态

validate

func

upload.validate()

组件校验

事件回调

配置

说明

配置

说明

image

文件状态改变的回调

image

上传前执行的回调

image

上传成功触发的回调

image

上传失败触发的回调

image

上传进度变化时的回调

  • 本页导读
  • 简介
  • 配置项
  • 属性与方法
  • 事件回调