quick-form表单生成组件配置说明

69 阅读3分钟

quick-form表单生成组件配置说明

quick-form Attributes

参数说明类型可选值默认值
label-widthlabel每项宽度string---150px
label-positionlabel对齐方式stringright/left/topright
fields表单配置项,具体看下方说明Array------
showScanTypeBtn是否显示浏览模式切换按钮Booleantrue,falsefalse
showFoldBtn是否显示收起、展开按钮Booleantrue,falsefalse
textModelColonVisible是否显示表单文字名称后的冒号Booleantrue,falsefalse
data表单数据回显,自动过滤表单配置没有的key的属性Object---{}
allDisabled全部表单元素禁用Booleantrue,falsefalse
borderForm是否给表单显示border 外框,包含区块外侧有一个 boder,以及区块标题的灰色背景Booleantrue,falsetrue
textModel文字模式。不显示表单组件,而是只显示纯文字内容,且会隐藏label 左边的星号Booleantrue,falseright
borderForm是否给表单显示border 外框,包含区块外侧有一个 boder,以及区块标题的灰色背景Booleantrue,falsetrue
formItemCol自定义表单每个要素的列,如果是 6 则为 一行 4 列,12 则为 1 行 2 列。如果为 0,则使用表单要素本身的设置,优先级高于表单要素本身的设置Number, String---0

quick-form Methods

方法说明参数
setElementDisable设置某个要素禁用参数为key和是否禁用,默认true禁用,设置false取消禁用Function(key:string,beDisable:boolean = true)
setElementHidden设置某个要素隐藏,默认true隐藏,设置false取消隐藏Function(key:string,beHidden:boolean = true)
setElementRequired设置某个要素必填,默认true必填,设置false取消必填Function(key:string,beRequired:boolean = true)
clearValidate清空校验信息---
resetFields重置表单数据---
updateFormData更新表单数据,参数为object,key匹配表单里的要素---

quick-form Events

方法说明回调参数
updateValue任一表单项数据变化后会触发回调表单项data对象

fields

说明:一个fields可包含多个区块,每个区块下面为一个展示块区域。

参数说明类型可选值默认值
label表单名称string------
class表单自定义样式,参数是对象,Key为需要添加的表单class样式,value为trueObject------
style表单行内样式Object---{}
children具体的表单项配置数组Array---[]

fields children

参数说明类型可选值默认值
key表单项名称,也就是我们表单提交的那个keystring------
type表单类型,支持常用的elementui的表单组件文本框(input),日期选择器(date-input),日期时间选择器(date-input-time),小时分钟输入框(hour-minute-input),日期范围输入框(date-range-input),下拉框(normal-select),普通数字输入框(normal-select),千分位数字输入框(number-input),动态下拉输入框(auto-complete-input),单选框(radio),多行文本框(textarea),多选框(checkbox),插槽(slot),独立插槽(slot-single)------
label表单项名称string------
disableDefault表单是否默认禁用booleantrue,false---
defaultValue表单默认值any------
isText表单是否以文本展示booleantrue,false---
span/size单个要素的列宽number---12
rules表单项校验,具体可参考element form表单校验array------
placeholder表单提示string------
valueLink表单项联动规则配置,数组对象,value为表单项的值,linkList为需要动态改变的表单项的值或者其他操作array------
style/class表单项样式Object------
onFocus,onBlur获取、失去焦点事件Function(e,data)------