上传按钮

更新时间:2025-01-17 03:35:47

上传按钮组件响应用户点击行为并将信息上传到服务器的能力的魔笔基础组件。

image

配置项

分类

配置

示例

说明

分类

配置

示例

说明

内容

按钮文字

image

按钮文字

按钮类型

image

按钮类型,可选项:主要按钮、默认按钮、虚线按钮、

文本按钮、链接按钮

开启徽标

image

开启徽标

徽标配置

image

数字:显示的数字

溢出数字:显示数字大于溢出数字后显示为溢出数字+

小红点:数字大于0时,不显示具体数字,而是显示一个红点

显示0:设置数字为0时是否显示

尺寸:徽标的大小

悬浮提示

image

是否开启悬浮提示

悬浮提示配置

image

内容:悬浮提示文本内容

背景颜色:悬浮提示的背景色

位置:悬浮提示相对按钮的位置

触发方式:触发悬浮提示显示的方式,有悬浮和点击可选

扩展配置

前缀图标

image

上传按钮的前缀图标

后缀图标

image

上传按钮的后缀图标

文件类型

image

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

最大数量

image

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

选择器类型

image

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

数据转化

image

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

标签

image

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

交互

隐藏

image

隐藏,详情参见通用属性

隐藏时保留布局

image

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

动作

image

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

系统路径

image

选择上传的目标系统路径

上传方法

image

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

上传地址

image

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

OSS凭证操作

image

创建 OSS 集成操作,并选择该操作,上传文件大于 5G 时,请选择分片上传凭证的集成操作类型

上传大小限制

image

上传大小限制

校验

image

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

加载

image

加载,组件显示加载态

禁用

image

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

样式

外边距

image

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

幽灵样式

image

幽灵样式,适用于视觉复杂背景,提供轻盈的界面元素,常见于展示性页面

危险按钮

image

危险按钮,标记可能带来严重后果的操作

按钮形状

image

按钮形状,可选项:默认、圆形、圆角

按钮布局

image

按钮在容器内的布局方式,可选项:通栏、左侧、中央、右侧

CSS样式

圆角

image

详情参见通用属性

按钮内容字体大小

image

按钮内容字体大小

按钮内容字体行高

image

按钮内容字体行高

默认按钮激活态背景色

image

详情参见通用属性

默认按钮激活态边框颜色

image

详情参见通用属性

默认按钮激活态文本颜色

image

详情参见通用属性

默认按钮悬浮态背景色

image

详情参见通用属性

默认按钮悬浮态边框颜色

image

详情参见通用属性

默认按钮悬浮态文本颜色

image

详情参见通用属性

默认按钮背景色

image

详情参见通用属性

默认按钮边框颜色

image

详情参见通用属性

默认按钮文本颜色

image

默认按钮文本颜色

主要按钮激活态背景色

image

详情参见通用属性

主要按钮激活态文本颜色

image

主要按钮激活态文本颜色

主要按钮悬浮态背景色

image

详情参见通用属性

主要按钮悬浮态文本颜色

image

主要按钮悬浮态文本颜色

主要按钮背景色

image

详情参见通用属性

主要按钮文本颜色

image

详情参见通用属性

链接按钮激活态文本颜色

image

链接按钮激活态文本颜色

链接按钮文本颜色

image

链接按钮文本颜色

链接按钮文本悬浮时颜色

image

链接按钮文本悬浮时颜色

文本按钮激活态背景色

image

详情参见通用属性

文本按钮禁用时文本颜色

image

文本按钮禁用时文本颜色

文本按钮文本颜色

image

文本按钮文本颜色

文本按钮悬浮时背景颜色

image

详情参见通用属性

属性与方法

名称

类型

示例

说明

名称

类型

示例

说明

text

string

buttonuploader.text

按钮文本

loading

boolean

buttonuploader.loading

按钮加载状态

disabled

boolean

buttonuploader.disabled

是否禁用当前按钮

value

array

buttonuploader.value

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

mode

string

buttonuploader.mode

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

parsedValues

array

buttonuploader.parsedValues

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

action

string

buttonuploader.action

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

disableUpload

boolean

buttonuploader.disableUpload

是否为阻止上传状态

extraHeader

object

buttonuploader.extraHeader

额外上传的请求头

extraData

object

buttonuploader.extraData

额外上传的数据

method

string

buttonuploader.method

上传方法

uploadProgress

number

buttonuploader.uploadProgress

上传进度

validationMessage

string

buttonuploader.validationMessage

校验结果信息

validationStatus

boolean

buttonuploader.validationStatus

是否通过校验

clearValue

func

buttonuploader.clearValue()

清除组件 value 值

setText

func

buttonuploader.setText('图片上传')

设置按钮文本

setLoading

func

buttonuploader.setLoading(true)

设置按钮加载状态

setDisabled

func

buttonuploader.setDisabled(true)

设置是否禁用当前按钮

setValue

func

buttonuploader.setValue(null)

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

setDisableUpload

func

buttonuploader.setDisableUpload(true)

设置阻止上传的状态位

setExtraHeader

func

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

设置额外上传头

setExtraData

func

buttonuploader.setExtraData({data:'data'})

设置额外上传数据

setAction

func

buttonuploader.setAction('system')

设置组件上传行为

setMethod

func

buttonuploader.setMethod('post')

设置上传方法

click

func

buttonuploader.click()

点击

clearValidate

func

buttonuploader.clearValidate()

清除验证状态

validate

func

buttonuploader.validate()

组件校验

事件回调

配置

说明

配置

说明

image

文件状态改变的回调

image

上传前执行的回调

image

上传成功触发的回调

image

上传失败触发的回调

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