在开源低代码表单设计器 form-create-designer 的右侧配置面板里,field
映射规则为开发者提供了强大的工具去自定义和增强组件及表单配置的显示方式。通过这些规则,你可以简单而高效地调整配置项的展示,提升用户体验。
源码地址: Github | Gitee | 文档
创新的组件配置映射
组件配置规则基于 props 方法开展,field
如果以 formCreate
开头,设计器将自动在规则中反映出相关字段的变更,这使得统一映射和修改组件配置成为可能。
组件字段映射举例:
配置字段 | 描述 |
---|---|
type | 与 rule.props.type 映射,类型可自由定义 |
options>label | 关联 rule.props.options 中的 label 字段,可自定义 |
formCreateStyle | 对应 rule.style 字段,自定义样式处理 |
formCreateStyle>width | 映射到 rule.style.width 字段,自定义宽度 |
formCreateChild | 应用于 rule.children[0],调整子元素 |
配置示例:
{
props(){
return [
{
type: 'input',
field: 'formCreateStyle>width',
title: '设置宽度',
props: {
width: '100px'
}
}
];
}
}
使用解释:
上述配置实现了 formCreateStyle>width
字段映射至组件的 rule.style.width
字段。这种设置允许开发者快速改变组件外观,而无需深入代码内部去找样式定义。
灵活的表单配置项映射
在表单配置中同样可以运用 field
规则自定义布局和扩展,进而达到个性化的表单表现。
表单字段映射展示:
配置字段 | 描述 |
---|---|
size | 影响 options.form.size 字段,用以调整表单尺寸 |
_submitBtn>show | 控制 options._submitBtn.show 字段,按钮显隐状态 |
>globalEvent | 改变 options 中的 globalEvent 字段,全局事件联动 |
>form>size | 触发 options.form.size 的变更,自定义尺寸 |
表单配置示例:
{
type: 'select',
field: 'size',
title: '选择表单尺寸',
props: {
options: [
{ label: '小号', value: 'small' },
{ label: '中号', value: 'medium' },
{ label: '大号', value: 'large' }
]
}
}
使用说明:
这段代码示例将 size 字段映射到表单的 options.form.size,供用户选择不同的表单大小,从而适应不同的视觉需求和交互体验。
总结
通过 form-create-designer 的字段映射规则可以极大提高开发工作效率,开发者不但能轻松个性化组件和表单的配置展示,还能为使用者提供灵活多样的交互体验。这一特性结合了配置的松散耦合与强大功能,是表单开发进程中不可或缺的部分。无须改动核心代码逻辑,只需专注于配置维护,即可获得复杂应用中的灵活性和可扩展性。