Skip to content

分组表单组件

在 FormCreate 中,可以通过 group 组件轻松实现子表单功能。子表单组件允许在表单内嵌套其他表单,适合用于处理需要重复的表单内容,如动态添加联系人、商品规格等场景。

基础的子表单

展示了一个简单的子表单,用户可以动态添加和删除表单项。

指定字段的子表单

该示例展示了如何只获取子表单中某个特定字段的值。

配置

props

参数名说明类型默认值
rule (必填)嵌套组件的生成规则Rule[]-
field只获取子表单中此字段String-
expand子表单默认展开几项Number-
options子表单的option配置Object-
button是否显示操作按钮Boolean-
max最多添加几项Number-
min最少添加几项Number0
modelValue (v-model)子表单的值any[]-
defaultValue设置新增子表单的默认值Object-
sortBtn是否显示顺序调整按钮Booleantrue
disabled是否禁用Booleanfalse
syncDisabled(弃用)与子表单强制同步 disabled 状态Booleantrue
onBeforeRemove删除时前置回调,返回false时取消操作(value: any[], index: number) => boolean|undefined-
onBeforeAdd新增时前置回调,返回false时取消操作(value: any[]) => boolean|undefined-
parse子表单创建前修改表单规则(rule:Rule[])=>Rule[]-

events

事件名说明返回值
changevalue 发生变化后触发-
add增加一项后触发-
remove删除一项后触发-
itemMounted新增的子表单初始化完成后触发-
[field-eventName]监听子表单 emit 事件,格式为子表单字段名拼接事件名称-

FormCreate 是一个开源项目,基于 MIT 许可证发布,欢迎个人和企业用户免费使用