上传按钮组件响应用户点击行为并将信息上传到服务器的能力的魔笔基础组件。
配置项
分类 | 配置 | 示例 | 说明 |
分类 | 配置 | 示例 | 说明 |
内容 | 按钮文字 | 按钮文字 | |
按钮类型 | 按钮类型,可选项:主要按钮、默认按钮、虚线按钮、 文本按钮、链接按钮 | ||
开启徽标 | 开启徽标 | ||
徽标配置 | 数字:显示的数字 溢出数字:显示数字大于溢出数字后显示为溢出数字+ 小红点:数字大于0时,不显示具体数字,而是显示一个红点 显示0:设置数字为0时是否显示 尺寸:徽标的大小 | ||
悬浮提示 | 是否开启悬浮提示 | ||
悬浮提示配置 | 内容:悬浮提示文本内容 背景颜色:悬浮提示的背景色 位置:悬浮提示相对按钮的位置 触发方式:触发悬浮提示显示的方式,有悬浮和点击可选 | ||
扩展配置 | 前缀图标 | 上传按钮的前缀图标 | |
后缀图标 | 上传按钮的后缀图标 | ||
文件类型 | 文件类型,多个用逗号隔开,如 .xls,.xlsx 可限制为 Excel 上传 | ||
最大数量 | 多文件上传时,允许上传的最大文件数 | ||
选择器类型 | 选择器类型,可选项:单文件、多文件、文件夹 | ||
数据转化 | 数据转化,自动解析文件内容 | ||
标签 | 标签,详情参见表单通用属性 | ||
交互 | 隐藏 | 隐藏,详情参见通用属性 | |
隐藏时保留布局 | 隐藏时保留布局,详情参见通用属性 | ||
动作 | 动作,默认行为需要自行指定上传地址,阿里云 OSS 模式下仅支持单文件,可选项:默认、上传至系统文件存储、上传至阿里云 OSS | ||
系统路径 | 选择上传的目标系统路径 | ||
上传方法 | 上传方法,可选项:POST、GET、PUT | ||
上传地址 | 默认动作下,设置上传地址 | ||
OSS凭证操作 | 创建 OSS 集成操作,并选择该操作,上传文件大于 5G 时,请选择分片上传凭证的集成操作类型 | ||
上传大小限制 | 上传大小限制 | ||
校验 | 校验,详情参见表单通用属性 | ||
加载 | 加载,组件显示加载态 | ||
禁用 | 禁用组件,禁用后不可交互 | ||
样式 | 外边距 | 外边距,详情参见通用属性 | |
幽灵样式 | 幽灵样式,适用于视觉复杂背景,提供轻盈的界面元素,常见于展示性页面 | ||
危险按钮 | 危险按钮,标记可能带来严重后果的操作 | ||
按钮形状 | 按钮形状,可选项:默认、圆形、圆角 | ||
按钮布局 | 按钮在容器内的布局方式,可选项:通栏、左侧、中央、右侧 | ||
CSS样式 | 圆角 | 详情参见通用属性 | |
按钮内容字体大小 | 按钮内容字体大小 | ||
按钮内容字体行高 | 按钮内容字体行高 | ||
默认按钮激活态背景色 | 详情参见通用属性 | ||
默认按钮激活态边框颜色 | 详情参见通用属性 | ||
默认按钮激活态文本颜色 | 详情参见通用属性 | ||
默认按钮悬浮态背景色 | 详情参见通用属性 | ||
默认按钮悬浮态边框颜色 | 详情参见通用属性 | ||
默认按钮悬浮态文本颜色 | 详情参见通用属性 | ||
默认按钮背景色 | 详情参见通用属性 | ||
默认按钮边框颜色 | 详情参见通用属性 | ||
默认按钮文本颜色 | 默认按钮文本颜色 | ||
主要按钮激活态背景色 | 详情参见通用属性 | ||
主要按钮激活态文本颜色 | 主要按钮激活态文本颜色 | ||
主要按钮悬浮态背景色 | 详情参见通用属性 | ||
主要按钮悬浮态文本颜色 | 主要按钮悬浮态文本颜色 | ||
主要按钮背景色 | 详情参见通用属性 | ||
主要按钮文本颜色 | 详情参见通用属性 | ||
链接按钮激活态文本颜色 | 链接按钮激活态文本颜色 | ||
链接按钮文本颜色 | 链接按钮文本颜色 | ||
链接按钮文本悬浮时颜色 | 链接按钮文本悬浮时颜色 | ||
文本按钮激活态背景色 | 详情参见通用属性 | ||
文本按钮禁用时文本颜色 | 文本按钮禁用时文本颜色 | ||
文本按钮文本颜色 | 文本按钮文本颜色 | ||
文本按钮悬浮时背景颜色 | 详情参见通用属性 |
属性与方法
名称 | 类型 | 示例 | 说明 |
名称 | 类型 | 示例 | 说明 |
text | string |
| 按钮文本 |
loading | boolean |
| 按钮加载状态 |
disabled | boolean |
| 是否禁用当前按钮 |
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 值 |
setText | func |
| 设置按钮文本 |
setLoading | func |
| 设置按钮加载状态 |
setDisabled | func |
| 设置是否禁用当前按钮 |
setValue | func |
| 设置当前文件上传组件的已选文件路径列表 |
setDisableUpload | func |
| 设置阻止上传的状态位 |
setExtraHeader | func |
| 设置额外上传头 |
setExtraData | func |
| 设置额外上传数据 |
setAction | func |
| 设置组件上传行为 |
setMethod | func |
| 设置上传方法 |
click | func |
| 点击 |
clearValidate | func |
| 清除验证状态 |
validate | func |
| 组件校验 |
事件回调
配置 | 说明 |
配置 | 说明 |
文件状态改变的回调 | |
上传前执行的回调 | |
上传成功触发的回调 | |
上传失败触发的回调 |
- 本页导读
- 配置项
- 属性与方法
- 事件回调