简介
文件上传组件是用于将信息上传到服务器的魔笔基础组件。
配置项
分类 | 配置 | 示例 | 说明 |
分类 | 配置 | 示例 | 说明 |
内容 | 标题 | 组件标题文本 | |
图标 | 组件图标 | ||
文件类型 | 文件类型,多个用逗号隔开,如 .xls,.xlsx 可限制为 Excel 上传 | ||
最大数量 | 多文件上传时,允许上传的最大文件数 | ||
选择器类型 | 选择器类型,可选项:单文件、多文件、文件夹 | ||
数据转化 | 数据转化,自动解析文件内容 | ||
展示上传列表 | 是否展示上传列表 | ||
标签 | 标签,详情参见表单通用属性 | ||
交互 | 隐藏 | 隐藏,详情参见通用属性 | |
隐藏时保留布局 | 隐藏时保留布局,详情参见通用属性 | ||
动作 | 动作,默认行为需要自行指定上传地址,阿里云 OSS 模式下仅支持单文件,可选项:默认、上传至系统文件存储、上传至阿里云 OSS | ||
系统路径 | 上传至系统文件存储时,选择上传的目标系统路径 | ||
上传方法 | 上传方法,可选项:POST、GET、PUT | ||
上传地址 | 默认动作下,设置上传地址 | ||
OSS凭证操作 | 上传资源至阿里云 OSS时显示此项,下拉选项为已创建的OSS集成操作 | ||
上传大小限制 | 上传文件的大小限制 | ||
禁用 | 禁用组件,禁用后不可交互 | ||
校验 | 校验,详情参见表单通用属性 | ||
样式 | 外边距 | 外边距,详情参见通用属性 | |
圆形样式 | 外观是否显示为圆形 | ||
字体大小 | 标题文字大小 |
属性与方法
名称 | 类型 | 示例 | 说明 |
名称 | 类型 | 示例 | 说明 |
value | array |
| 当前文件上传组件的已选文件路径列表 |
mode | string |
| 只读,当前文件上传组件的模式 |
parsedValues | array |
| 只读,当前文件上传组件的已选文件转化后的文件列表 |
action | string |
| 默认上传动作,值为以下几种:default(默认)、system(上传至系统文件存储)、aliyun-oss(上传至阿里云 OSS) |
disableUpload | boolean |
| 是否为阻止上传状态 |
extraHeader | object |
| 额外上传的请求头 |
extraData | object |
| 额外上传的数据 |
method | string |
| 上传方法 |
uploadProgress | number |
| 上传进度 |
validationMessage | string |
| 校验结果信息 |
validationStatus | boolean |
| 是否通过校验 |
clearValue | func |
| 清除组件 value 值 |
setValue | func |
| 设置当前文件上传组件的已选文件路径列表 |
setDisableUpload | func |
| 设置阻止上传的状态位 |
setExtraHeader | func |
| 设置额外上传头 |
setExtraData | func |
| 设置额外上传数据 |
setAction | func |
| 设置默认上传路径 |
setMethod | func |
| 设置上传方法 |
clearValidate | func |
| 清除验证状态 |
validate | func |
| 组件校验 |
事件回调
配置 | 说明 |
配置 | 说明 |
文件状态改变的回调 | |
上传前执行的回调 | |
上传成功触发的回调 | |
上传失败触发的回调 | |
上传进度变化时的回调 |
- 本页导读
- 简介
- 配置项
- 属性与方法
- 事件回调