利用开源的低代码表单设计器FcDesigner高效管理和渲染复杂表单结构

FcDesigner 是一个强大的开源低代码表单设计器组件，支持快速拖拽生成表单。提供丰富的自定义及扩展功能，FcDesigner支持多语言环境，并允许开发者进行二次开发。通过将表单设计输出为JSON格式，再通过渲染器进行加载，实现简单灵活的表单设计和管理。无论是前端入门者还是资深开发者，FcDesigner都是一个理想的工具，帮助他们更高效地创建和部署复杂的表单应用。

源码地址: Github | Gitee | 文档

项目使用 Vue 与 ElementPlus/ElementUI 构建界面，支持多语言和自定义组件扩展，允许开发者进行二次开发。

该项目主要由两部分组成：

1. 设计器工具：form-create-designer
2. 表单渲染器：form-create

用户可以通过设计器创建表单设计，并将其导出为JSON格式。渲染器则根据JSON数据重现和渲染表单。

• @form-create/designer: 为PC端提供表单设计功能 💻
• @form-create/vant-designer: 适用于移动端的表单设计器 📱

开始使用

请按照以下步骤在 Vue 3 项目中安装和使用

@form-create/designer

。

安装

首先，在您的项目中安装 @form-create/designer 的 Vue 3 版本：

npm install @form-create/designer@^3

接着，安装 form-create 的 Vue 3 版本：

npm install @form-create/element-ui@^3

引入组件

通过CDN引入

如果您选择使用 CDN，在HTML文件中包含以下代码：

<linkhref="https://unpkg.com/element-plus/dist/index.css"rel="stylesheet"/><scriptsrc="https://unpkg.com/vue"></script><scriptsrc="https://unpkg.com/element-plus/dist/index.full.js"></script><scriptsrc="https://unpkg.com/@form-create/element-ui@next/dist/form-create.min.js"></script><scriptsrc="https://unpkg.com/@form-create/designer@next/dist/index.umd.js"></script><divid="app"><fc-designerheight="100vh"></fc-designer></div><script>const{ createApp }= Vue;const app =createApp({});
    app.use(ElementPlus);
    app.use(FcDesigner);
    app.use(FcDesigner.formCreate);
    app.mount('#app');</script>

通过Node.js引入

若您的项目采用 Node.js 环境，使用以下方法引入并配置：

import{ createApp }from'vue';import FcDesigner from'@form-create/designer';import ElementPlus from'element-plus';import'element-plus/dist/index.css';const app =createApp(App);
app.use(ElementPlus);
app.use(FcDesigner);
app.use(FcDesigner.formCreate);
app.mount('#app');

使用设计器

在 Vue 3 组件中，可以如下使用 fc-designer 组件：

<template><fc-designer ref="designer" height="100vh"/></template><script setup>import{ ref }from'vue';const designer =ref(null);</script>

表单渲染与处理

使用

formCreate

和

FcDesigner

进行设计和渲染时，确保正确转换和处理 JSON 数据格式至关重要。

获取与保存设计数据

在表单设计完成后，通过以下方法获取表单规则和配置并保存：

const ruleJson =this.$refs.designer.getJson();const optionsJson =this.$refs.designer.getOptionsJson();// 代码保存 JSON 数据至数据库

回显与渲染设计表单

您可重载先前保存的设计表单数据并将其呈现：

this.$refs.designer.setOptions(optionsJson);this.$refs.designer.setRule(ruleJson);

若需进行表单的渲染，需在 Vue 应用中加载 form-create 并设置表单规则与配置：

import{ formCreate }from'@form-create/designer';
app.use(formCreate);

示例如下：

<template><div id="app"><form-create v-model="formData" v-model:api="fApi":rule="rule":option="option"></form-create></div></template><script>import{ formCreate }from'@form-create/designer';exportdefault{data(){return{
                fApi:{},
                formData:{},
                rule:[],
                option:{}}},beforeCreate(){const[rule, option];// 加载表单 JSON 规则this.rule = formCreate.parseJson(rule);this.option = formCreate.parseJson(option);}}</script>

动态加载与保存配置

通过API接口，可动态操作表单配置：

import axios from'axios';asyncfunctionloadFormConfig(){try{const response =await axios.get('/api/form-config');return response.data;}catch(error){
        console.error('加载表单配置失败', error);return{ rule:[], option:{}};}}asyncfunctionsaveFormConfig(ruleJson, optionsJson){try{await axios.post('/api/form-config',{ rule: ruleJson, options: optionsJson });}catch(error){
        console.error('保存表单配置失败', error);}}

通过以上步骤，您可以高效创建、保存和加载复杂的表单设计。

高级功能与自定义组件扩展

FcDesigner 除了提供基础的表单设计功能外，还支持高级功能和自定义组件的扩展。这让开发者可以根据不同业务需求扩展组件库，打造更为复杂和个性化的表单解决方案。

创建自定义组件

您可以通过自定义组件扩展 FcDesigner，满足特定的业务需求。以下是一个简单的自定义组件实现示例：

<template><el-input v-model="value" placeholder="请输入内容"></el-input></template><script>exportdefault{
    name:'CustomInput',
    props:{
        modelValue:{
            type: String,default:''}},
    computed:{
        value:{get(){returnthis.modelValue;},set(val){this.$emit('update:modelValue', val);}}}}</script>

注册自定义组件

在 Vue 应用中注册自定义组件，与 FcDesigner 一起使用：

import CustomInput from'./components/CustomInput.vue';

app.component('CustomInput', CustomInput);const customComponent ={
    type:'custom-input',
    menu:'main',rule(){return{
            type:'CustomInput'}}props(){}// 可添加自定义参数};

FcDesigner.registerComponent(customComponent);

高级功能示例

除自定义组件外，FcDesigner 还支持各种高级功能，包括但不限于：

1. 动态校验规则：根据表单数据实时调整校验逻辑。
2. 联动效果：实现表单项间的联动变化，比如选择不同选项时展示不同的组件。
3. 外部数据源加载：通过 API 获取动态数据源，丰富表单内容。
4. 复杂交互逻辑：通过事件和方法，实现复杂的交互行为。

大规模应用与优化

在大规模应用中，优化表单的渲染性能和响应速度至关重要。以下是一些优化建议：

1. 按需加载组件：仅在需要时加载必要的组件，以减少初始加载时间。
2. 开启渐进式数据加载：对于长表单或复杂表单，考虑分阶段加载数据。

通过这些措施，FcDesigner 可以充分发挥其高扩展性和强大的功能，为开发者提供一流的低代码表单设计体验。无论是简单的表单应用，还是复杂的企业级表单需求，FcDesigner 都能为您带来显著的开发效率提升和用户体验优化。