如何搭积木式的快速开发 H5 页面?

关注

发布于: 2020 年 12 月 15 日

2 个月前开源的 H5 编辑器 H5-Dooring 目前已经成功迭代到 1.0 版本, 从最开始的基本的页面生成框架到现在的支持更丰富的组件资源,交互能力和数据追踪能力, 期间做了很多的设计和迭代,也收获了很多网友的反馈和启发, 也有很多志同道合的朋友加入进来一起让 H5-Dooring 变的更好更强大, 在此特意分享一下我们最新的版本和功能实现.

设计初衷

笔者最开始开发这个项目的主要目的是提高个人和企业开发 H5 页面的成本和效率, 可以通过搭积木的方式, 利用已有组件库或外部组件资源(正在设计)搭建出适合不同场景的 H5 应用, 并且支持一键下载代码, 让技术人员轻松将 H5 页面部署到自己的服务器中. 笔者之前也做过很多代码生成的小应用, 但是都是为程序员少写代码而设计的, 不足以成为一个真正的开源项目, 所以笔者打算把 H5-Dooring 好好落地, 做成一个真正有价值的项目.

笔者接下来将介绍最新版 H5 编辑器的功能和实现思路, 以及如何实现所见即所得的方案尝试.

技术栈

之前在笔者的文章中也介绍过 H5-Dooring 使用的技术栈和基础架构实现了, 感兴趣的可以参考基于React+Koa实现一个h5页面可视化编辑器

最近我们在用 nest 重构项目的后端部分, 后期会做一定的技术方案介绍. 这里简单介绍一下项目实现的技术栈:

umi3.0 + dva + antd4.0
react + react 生态
nest + mysql + redis
nginx + pm2

所以这个项目属于一个全栈项目, 很多核心功能的实现取决的约定好的 DSL 层, 页面渲染层和后端能力.

功能点和实现方案

笔者之前的系列文章中有介绍具体功能点和实现方案, 这里我们主要介绍 1.0 版本已有的新功能.

新增富文本组件, 日历组件, 按钮交互组件, 专栏组件

富文本组件笔者采用的是国产的 braft, 预览如下:

因为项目用 antd4.0 开发的, 所以笔者专门封装了一套适配 antd4.0 组件的富文本编辑器, 支持 Form 组件的受控模式. 感兴趣的可以子啊 github 上学习具体的实现方式.

日历组件也是最近刚加的, 主要是为了实现更丰富的 H5 页面展示, 如下:

我们可以设置选择的时间范围, 被选择范围的主色, 日期等. 日期组件笔者主要采用的 zarm 的 Calendar 组件, 核心如下:

import React, { useState, memo, useEffect, useRef } from 'react';import { Calendar } from 'zarm';import styles from './index.less';import { ICalendarConfig } from './schema';
const CalendarPlayer = memo((props: ICalendarConfig & { isTpl: boolean }) => {  const { time, range, color, selectedColor, round, isTpl } = props;  const realRange = range.split('-');
  const [value, setValue] = useState<Date[] | undefined>([new Date(`${time}-${realRange[0]}`), new Date(`${time}-${realRange[1]}`)]);  const [min] = useState(new Date(`${time}-01`));  const [max] = useState(new Date(`${time}-31`));  const boxRef = useRef<any>(null);  return <div className={styles.calenderWrap} style={{borderRadius: round + 'px', pointerEvents: isEditorPage ? 'none' : 'initial'}} ref={boxRef}>          <Calendar            multiple={!!range}            value={value}            min={min}            max={new Date(max)}            disabledDate={(date:any) => /(0|6)/.test(date.getDay())}            onChange={(value:Date[] | undefined) => {              setValue(value);            }}          />        </div>});
export default CalendarPlayer;复制代码

复制代码

这也是实现 Dooring 组件的一种方式, 感兴趣的朋友欢迎为 Dooring 添加更多丰富组件支持.

之前还有个朋友问过我为什么项目利使用了这么多组件在预览 H5 页面的时候速度还是很快, 这里我说明一下具体的实现方式, 如下图:

所以说我们移动端的产物和依赖的资源非常少, 并且在 webpack 层和服务器层做了优化, 所以移动端访问 H5 页面会非常快, 这块优化笔者后期会详细介绍, 目前对性能这块还在持续优化.

按钮交互组件笔者之前也写过文章专门详细的介绍过如何实现按钮交互, 自定义交互代码以及富文本弹窗交互等, 感兴趣的可以参考文章低代码开发平台核心功能设计——组件自定义交互实现.

笔者这里展示一下具体的交互方式:

打开弹窗的交互用户可以自定义弹窗中的内容, 如下:

此时在手机端的预览效果如下:

对于自定义code这块, 笔者集成了代码编辑库codemirror, 这样我们就可以自定义实现交互能力了, 如下效果:

接下来是我们的专栏组件, 这块主要是基于业务需求做的业务组件, 实现方式和基础组件一样, 大家可以在线体验一下.

新增导入导出 json 文件功能

之所以会做这个功能主要是为了方便协作设计 H5 页面的, 比如说一个人设计了一个 H5 页面想让其他人一起参与设计, 可以将当前 H5 页面导出为JSON, 另一个人通过导入这个 JSON 文件就可以立马渲染成一模一样的 H5 页面, 进而做修改或者完善. 如下:

关于如何实现下载json, 笔者在之前的文章中也介绍过, 我们可以采用file-saver这个第三方模块来做. 上传解析json 我们完全可以自己实现, 笔者采用的是 Upload + FileReader API实现的, 核心代码如下:

const uploadprops = useMemo(() => ({    name: 'file',    showUploadList: false,    beforeUpload(file, fileList) {      // 解析并提取json数据      let reader = new FileReader();      reader.onload = function(e) {        let data = e.target.result;        importTpl && importTpl(JSON.parse(data))      };      reader.readAsText(file);    }  }), []);复制代码