开源动态表单form-create-designer 扩展个性化配置的最佳实践教程

发布于:2024-11-27 ⋅ 阅读:(7) ⋅ 点赞:(0)

在开源低代码表单设计器 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 的字段映射规则可以极大提高开发工作效率,开发者不但能轻松个性化组件和表单的配置展示,还能为使用者提供灵活多样的交互体验。这一特性结合了配置的松散耦合与强大功能,是表单开发进程中不可或缺的部分。无须改动核心代码逻辑,只需专注于配置维护,即可获得复杂应用中的灵活性和可扩展性。