分组表单组件
在 FormCreate 中,可以通过 group 组件轻松实现子表单功能。子表单组件允许在表单内嵌套其他表单,适合用于处理需要重复的表单内容,如动态添加联系人、商品规格等场景。
基础的子表单
展示了一个简单的子表单,用户可以动态添加和删除表单项。
指定字段的子表单
该示例展示了如何只获取子表单中某个特定字段的值。
配置
props
参数名 | 说明 | 类型 | 默认值 |
---|---|---|---|
rule (必填) | 嵌套组件的生成规则 | Rule[] | - |
field | 只获取子表单中此字段 | String | - |
expand | 子表单默认展开几项 | Number | - |
options | 子表单的option 配置 | Object | - |
button | 是否显示操作按钮 | Boolean | - |
max | 最多添加几项 | Number | - |
min | 最少添加几项 | Number | 0 |
modelValue (v-model) | 子表单的值 | any[] | - |
defaultValue | 设置新增子表单的默认值 | Object | - |
sortBtn | 是否显示顺序调整按钮 | Boolean | true |
disabled | 是否禁用 | Boolean | false |
syncDisabled(弃用) | 与子表单强制同步 disabled 状态 | Boolean | true |
onBeforeRemove | 删除时前置回调,返回false 时取消操作 | (value: any[], index: number) => boolean|undefined | - |
onBeforeAdd | 新增时前置回调,返回false 时取消操作 | (value: any[]) => boolean|undefined | - |
parse | 子表单创建前修改表单规则 | (rule:Rule[])=>Rule[] | - |
events
事件名 | 说明 | 返回值 |
---|---|---|
change | value 发生变化后触发 | - |
add | 增加一项后触发 | - |
remove | 删除一项后触发 | - |
itemMounted | 新增的子表单初始化完成后触发 | - |
[field-eventName ] | 监听子表单 emit 事件,格式为子表单字段名拼接事件名称 | - |