Skip to content

ProBaseForm

ProBaseForm 是一个基于 Naive UI 的表单组件封装,旨在简化表单的开发过程。通过配置化的方式,您可以快速生成表单,并具备灵活的布局和组件定制能力。该组件使用了 n-formn-gridn-form-item-giNaive UI 组件,实现响应式布局和表单项的快速渲染。

基础用法

请输入姓名
请输入年龄
请输入地址
{"name":"","age":null,"address":""}
Default
expand codecollapse code

自定义布局和组件

请输入邮箱
请输入密码
{"email":"","password":"","remember":false}
Default
expand codecollapse code

Props

参数类型默认值说明
columnsProBaseFormColumn[]表单项的配置数组,定义每个表单项的属性
colsnumber24网格布局的列数,总共 24 列
xGapnumber12网格项之间的水平间距,单位为像素
yGapnumber0网格项之间的垂直间距,单位为像素
columnsSpannumber24表单项在网格布局中占据的列数
footerSpannumber24底部插槽在网格布局中占据的列数
collapsedbooleanfalse是否折叠网格布局,参见 n-gridcollapsed 属性
collapsedRowsnumber1折叠时显示的行数,参见 n-gridcollapsed-rows 属性
modelValueobject{}表单的数据对象,使用 v-model 进行双向绑定

更多参数请参考 n-formn-grid 的属性。

Columns

参数类型默认值说明
labelstring表单项的标签文本
propstring表单项绑定的数据字段名
componentstring | VNode表单项使用的组件,可以是组件名字符串或 VNode 对象
propsRecord<string, any>{}传递给组件的属性,键值对形式
spannumber表单项在网格布局中占据的列数,默认为 columnsSpan 的值
showbooleantrue是否显示该表单项,false 时隐藏

Component Field Types

名称说明
date-picker日期选择器
auto-complete自动完成
cascader级联选择器
input输入框
input-number数字输入框
rate评分
time-picker时间选择器
mention提及
select选择器
switch开关
slider滑块
radio单选框
checkbox多选框
textarea多行输入框