Skip to content

from 表单组件

以下为表单的联动示例

显隐联动

通过配置 linkShowPropslinkShowCb来实现

禁用联动

通过配置 linkDisabledPropslinkDisabledCb来实现

值联动

通过配置 linkValuePropslinkValueCb来实现

select值联动

通过配置 linkOptionsPropslinkOptionsCb来实现

API

属性说明Type默认值
config表单配置信息,同submit组件的formConfigArray-
rules表单验证规则Object-
submitStatus提交时 disabled 状体, true 为禁用表单booleanfalse

formItems 配置

属性说明Type默认值
type表单类型:
XbSelect(下拉)
XbInput(输入框)
XbDatePicker(日期选择)
XbRadio(单选)
XbSwitch(开关)
XbUpload(图片上传)配置详见upload组件
XbFormJson(联合组件)
XbInputNumber(数字输入框)
string-
label标签文本string-
propName表单提交key值,接口接受如果为多个字段使用-隔开如:startTiem-endTimestring-
defaultValue默认值--
propAttrs表单的属性配置,详见element-plus对应的组件配置object-
formItemPropAttrselFromItem 的样式,详见FormItem APIobject-
disabled是否禁用boolean-
layout栅格占据的列数, 覆盖 submit/search组件 的 layout
xs: <768px
sm: ≥768px
md: ≥992px
lg: ≥1200px
xl: ≥1920px
object{
  span: 24,
}
requestApi获取下拉菜单值接口/上传文件的接口,类型为XbSelect/Xbupload有效function-
responseFormat格式化获取下拉菜单值接口返回值/格式化上传文件返回值,类型为XbSelect/Xbupload有效function-
optionsoptions radio 子项, 类型为XbRadio,
格式为:
{
  id:"",
  name: ""
}
-
disabledControl控制显示隐藏, 类型为XbFormJson的子组件时有效function(index)-
slots插槽目前支持 extra, prepend, append, 详见slots(#)Object---

config - 联动相关

属性说明Type默认值
linkOptionsProps联动表单的 propName 值,类型为XbSelect有效array-
linkOptionsCb联动表单值改变后回调, 需 resolve(newVal) 一个新值
val 关联表单的值
key 关联表单的key
resolve 用于返回一个新的值
formData 当前表单所有值
(注:关联多个表单会执行多次,使用 formData 取值判断)
function(val, key, resolve, formData)-
linkDisabledProps联动表单的 propName 值,联动是否禁用时使用array-
linkDisabledCb联动表单是否禁用回调, 需return布尔值
true 禁用 / false 不禁用
参数值同 linkOptionsCb
function(val, key, formData)-
linkShowProps联动表单的 propName 值,联动是否显隐时使用array-
linkShowCb联动表单是否显示回调, 需return布尔值
true 禁用 / false 不禁用
参数值同 linkDisabledCb
function(val, key, formData)-
linkValueProps联动表单的 propName 值,联动值的时候使用array-
linkValueCb联动表单值的回调, 需return新值
参数值同 linkDisabledCb
function(val, key, formData)-

config - 类型为XbSelect相关

属性说明Type默认值
defaultOptions下拉菜单默认值,类型为XbSelect有效,
格式为:
{
  id:"",
  name: ""
}
ref/array-
requestParams获取下拉菜单值接口的参数,类型为XbSelect有效function-
valChangeCb下拉菜单值改变时回调function(val)-

config - 类型为XbFormJson相关

属性说明Type默认值
min内容最小数量number0
max内容最大数量numberInfinity
formItems内容配置array[]

slots - 表单插槽

属性说明Type默认值
extra表单组件下文字提示,值为xbTemplate时,为自定义, #propNameExtraXbFstring-
prepend表单组件前缀内容,值为xbTemplate时,为自定义, #propNamePrependXbFstring-
append表单组件后缀内容,值为xbTemplate时,为自定义, #propNameAppendXbFstring-