Dooring-Saas低代码技术详解

背景介绍

3年前我上线了第一版自研零代码引擎 H5-Dooring, 至今已迭代了 300 多个版本, 主要目的是快速且批量化的生产业务/营销过程中的复用页面, 远离 curd 循环. 比如我们在研发中常遇到的:

• H5可复用的业务模版
• 页面通用能力封装
• 页面搭建上的灵活性和复用性
• 通用业务组件库
• 动态表单复用性
• 图表库复用性

等问题, 为了实现这一目标, 需要系统的针对这些问题进行产品设计, 当时就想到了通过低代码的模式来解决. 也就有了我们在 github 看到的解决方案: H5-Dooring 开源项目.

图片

当时做了一个3年的规划, 没想到3年这么快就到了.

取得的一些成绩

• github star : 7.8k+
• 线上累计注册用户: 10000+
• 线上页面总数: 5000+
• 模版总数: 1000+
• 组件总数: 45+(持续生产中)

同时为了让技术小伙伴更好的研究学习低代码和零代码, 我在掘金和趣谈前端公众号里也写了10多篇低代码的实现原理的文章, 后续也会随着产品不断迭代持续分享最新的技术实现.

正文

接下来我会从

• 编辑器设计架构
• 产品设计思路
• 入口工程设计架构
• 服务端技术思考

这几个方面, 来和大家详细介绍一下 Dooring-Saas 这款开箱即用的零代码搭建平台.

编辑器相关

图片

Dooring-Saas 是一款功能强大，高可扩展的零代码解决方案，致力于提供一套简单方便、专业可靠、无限可能的页面可视化搭建最佳实践。

图片

功能特点

• 🎉 可扩展， Dooring 实现了较为完整的业务闭环，并使其模块化，编辑器内部功能接口也全部可以对接不同服务端语言，实现了标准化接口。此外还支持自定义组件，二次开发，设计模板等能力，以满足功能和跨领域的分层需求。
• 📦 开箱即用， Dooring 内置了表单渲染器、页面渲染器、动态加载内核等，仅需一套源码即可上手开发。并且还提供针对 React 的定制插件，内涵丰富的功能，可满足日常 30%-60%的页面制作需求。
• 🚀 大量自研， 包含整个编辑器架构、组件设计、文档、请求库封装，后台管理系统等，满足日常项目的周边需求。
• 🚄 与时俱进， 在满足需求的同时，我们也不会停止对新技术的探索。比如更多营销组件, 可视化组件, 功能组件等等。

1. 搭建协议设计

Dooring 可编辑组件 Schema 设计

Schema 分两部分:

• editData 组件可编辑属性的数组
• config 组件真正消费的数据

editData 详解

editData 是 组件属性可编辑项的数组, 每一项里面包含了如下字段:

• key 属性名
• name: 属性名的中文显示
• type: 属性的可编辑类型
• isCrop(可选)
• cropRate(可选)
• range(type 为'Radio'或'Select'时的选项数组)
• 后期可能会扩展(详细结构可参考Dooring 开源版本)

key和name 都可以按照组件属性的语义来定, 这里值得一提的是 type. 不同属性的值类型不同, 所以我们编辑项的 type 也不同, 所有的类型如下:

• Upload 上传组件
• Text 文本框
• RichText 富文本
• TextArea 多行文本
• Number 数字输入框
• DataList 列表编辑器
• FileList 文件列表编辑器
• InteractionData 交互设置
• Color 颜色面板
• MutiText 多文本
• Select 选择下拉框
• Radio 单选框
• Switch 开关切换
• CardPicker 卡片面板
• Table 表格编辑器
• Pos 坐标编辑器
• FormItems 表单设计器

更详细的代码可以参考私有化部署版的editor/src/core/FormComponents 目录.

config 详解

config 本质上是一个对象, 也就是组件所能暴露出来的属性集合, 和 editData 数组每一项的key 一致, 如下:

{
    cpName: 'Header',
    logoText: '',
    fontSize: 20,
    color: 'rgba(47,84,235,1)',
    height: 60,
    fixTop: false,
    menuList: [
      {
        id: '1',
        title: '首页',
        link: '/'
      },
      {
        id: '2',
        title: '产品介绍',
        link: '/'
      },
    ]
  }

editData 和 config 构成了一个 Dooring 组件的 schema 结构, 所以我们可以发现, 每一个 dooring 组件都具备如下结构:

• index.tsx 组件主文件(可以集成任何第三方开源库)
• index.less 组件的样式文件
• schema.ts 组件的schema(组件描述协议)

• editData
• config

当然组件的 schema 也可以根据自己的需求来扩展, 如果在组件设计上有疑问的, 可以随时和我沟通.

2. 组件物料开发

组件物料开发依赖于上一节说的搭建协议的设计, 在开发 Dooring 自定义组件时我们只需要按照通用的 react 组件开发模式来写我们的组件即可, 唯一不同的就是每一个组件都需要定义自己的schema 文件, 这也是低代码/零代码组件开发的通用模式.

接下来我拿 Header 组件来和大家介绍一下如何开发自定义的低代码组件.

Header组件的主文件开发

import styles from './index.less';
import React, { memo, useState } from 'react';
import { IHeaderConfig } from './schema';

const Header = memo((props: IHeaderConfig) => {
  const { cpName, bgColor, logo, height } = props;

  return (
    

      

        你的自定义的header内容
      
    
  );
});

export default Header;

Header样式文件

.header {
    box-sizing: content-box;
    padding: 3px 12px;
    background-color: #000;
    .logo {
      max-width: 160px;
      overflow: hidden;
      img {
        height: 100%;
        object-fit: contain;
      }
    }
  }

Header的Schema设计

const Header = {
      editData: [
        ...baseConfig,
        {
          key: 'bgColor',
          name: 背景色,
          type: 'Color',
        },
        {
          key: 'height',
          name: 高,
          type: 'Number',
        },
        {
          key: 'logo',
          name: 'logo',
          type: 'Upload',
          isCrop: false,
          cropRate: 1000 / 618,
        }
      ],
      config: {
        ...baseDefault,
        bgColor: 'rgba(245,245,245,1)',
        logo: [
          {
            uid: '001',
            name: 'image.png',
            status: 'done',
            url: 'https://www.528045.com/file/upload/202411/30/agqgljs3kbb.png',
          },
        ],
        height: 50,
      },
    };
    
    export default Header;

在开发完组件后, 我们需要把组件导入到对应的组件分类入口, 比如基础组件(BasicComponents),我们需要在BasicComponents/schema.ts 中导入并导出:

import Carousel from './Carousel/schema';
import Form from './Form/schema';
import Header from './Header/schema';
import WhiteTpl from './WhiteTpl/schema';
import Icon from './Icon/schema';
import Image from './Image/schema';
import Shape from './Shape/schema';
import LongText from './LongText/schema';
import Notice from './Notice/schema';
import Qrcode from './Qrcode/schema';
import Text from './Text/schema';
import Title from './Title/schema';

const basicSchema = {
  Carousel,
  Form,
  Header,
  Icon,
  Image,
  LongText,
  Title,
  // ...其他组件
};
export default basicSchema;

组件元信息定义

组件设计好之后在编辑器中还无法看到, 这是应该我们需要配置一下组件的初始化元信息, 比如从组件面板拖入画布之后的组件大小, 组件的名称等, 具体的定义路径在:

• editor/src/components/BasicShop/template.ts

具体定义介绍:

{
    base: [
        {
            type: 'Header',   // 组件类型
            h: 66,  // 组件初始高度px
            w: 375, // 组件宽度px
            displayName: '页头组件',  // 组件展示信息
            icon: 'https://www.528045.com/file/upload/202411/30/404gwlqfqhw.png',  // 组件展示icon
            category: 'base'  // 组件的上层分类
        }
    ],
}

3. 渲染器设计

渲染器主要包括搭建模式和渲染模式两部分, 接下来具体介绍一下.

搭建模式

目前 Dooring-Saas 支持两种搭建模式:

• 智能网格布局(二维空间排列, 空余空间自动补位)
• 自由布局(三维自由布局, 支持图层, 元素自由叠加)

具体的实现模式可以参考私有化部署代码的:

• editor/src/core/viewRender.tsx

渲染模式

Dooring-Saas 的组件均采用动态加载的方式来渲染, 也就是页面在渲染的时候, 组件是异步加载的, 这样可以提高首频屏渲染性能, 我们采用的 import 来实现, 具体的动态加载模式路径为:

• editor/src/DynamicEngine.tsx

图片

对于每一个元素的位置, 我们采用如下结构来设计:

{
    point: {
    "w": 24,   // 组件宽度
    "h": 30,   // 组件高度
    "x": 0,    // x坐标
    "y": 26,   // y坐标
    "i": "wb3d1LFIX3",  // 组件id
    "moved": false,
    "static": false, 
    "isBounded": true 
    }
}

属性动态配置面板

图片

属性动态面板主要是指组件右边编辑区, 它可以基于组件 schema 的 editData 字段值, 基于表单渲染引擎来动态的渲染出来. 表单渲染引擎位置:

• editor/src/core/FormRender

这块也是我们自研的一套机制, 私有化的企业可以基于这套模式做进一步扩展, 优化.

4. 预览模块设计与实现

图片

预览模块分两部分:

• 编辑器画布的实时预览
• 预览页面的预览

编辑器画布的实时预览

编辑器画布的实时预览依赖于一套数据共享机制, 这里我们采用 dva 来实现全局状态的管理, 具体路径:

• src/pages/editor/models

我们可以在这里扩展编辑器项目的全局数据.

预览页面的预览

预览页面的预览来自于 entry 入口功能, 这块在 文档的全局入口 模块会详细介绍.

5. 出码模块设计

出码模块主要有:

• 生成编译版本页面代码
• 生成小程序
• 生成页面 json schema 文件

图片

6. 数据源设计

图片

有关数据源的分享我之前在《趣谈前端》中做了详细的介绍, 大家可以在我往期的文章中学习了解.

入口工程架构设计

目前入口工程我们主要采用 vue3 + vite 的技术方案, 包含如下部分:

• 入口页面(用户应用列表, 模版列表, 权益相关)
• 公共资源模块(素材库, 文件库)
• 预览页面

之所以这么设计是为了降低系统的复杂性, 编辑器只负责编辑搭建模块, 后面增加复杂度不会对整个工程造成性能和维护性的影响.

管理模块

埋点分析:

图片

数据大盘:

图片

后端服务介绍

后台服务主要采用的 nest + mysql + redis, 接口遵循 restful 规范, 并且提供了接口文档，企业可以轻松基于此使用自己的后端语言来接入, 比如 java, python, go, php 等。

• tencentcloud-sdk 短信服务
• 七牛云 sdk 资源云储存
• 微信 sdk 实现微信登录，微信分享等功能
• puppeteer 实现 html 转图片，html 转 pdf 等
• nodemailer-smtp-transport 实现邮件服务