如何设计高扩展的在线网页制作平台

石头船长

前端工程师

官网

官网： https://godspen.ymm56.com/

使用手册： https://godspen.ymm56.com/doc/cookbook/introduce.html

在线体验： https://godspen.ymm56.com/admin/#/home

私有部署： https://godspen.ymm56.com/doc/cookbook/install.html

如何设计高扩展的在线网页制作平台

本文主要介绍如何设计一个高扩展的在线网页制作平台，会交代一些背景和最终的效果以及核心设计方案。

背景

2018年3月份开始，随着运满满的快速发展，开始在频繁的迭代各种活动，那时最快的方式就是拷贝老的活动项目，然后按需求修改，接着上线，然而这种方式很快就遇到了瓶颈，迫使运营团队也会去寻找一些第三方平台去满足自己的运营要求，不过由于定制化弱和用户信息没打通导致没办法大量使用，还是只能等待前端资源排期，两个比较突出的问题。

针对这些问题团队迫切需要一个平台来提供运营快速创建活动，开发也能在这平台做一些功能扩展。最好能满足已下几个要求：

针对这些要求我们做了码良平台，码良是一个在线H5编辑器，用于快速制作H5页面。用户无需掌握复杂的编程技术，通过简单拖拽、少量配置即可制作精美的页面，可用于营销场景下的页面制作。同时，也为开发者提供了完备的编程接入能力，通过脚本和组件的形式获得强大的组件行为和交互控制能力。

核心设计

下面会分享下我们的核心设计，这次主要重点说明下面几方面内容 1. 我们会介绍整体的架构来了解一般的编辑产生页面的基本思路，基于数据编程。 2. 我们会介绍核心的组件如何设计，确保可以自由扩展组件能力 3. 我们会介绍如何设计编辑器达到可自定义属性的控制面板备注（由于整体项目实现使用的VUE，所以后面有部分介绍具体技术实现的时候会以VUE的使用角度说明。用其他框架的自行脑补）

整体架构

整体架构整体架构相对简单，核心就是定义一套标准的数据规范，提供一个编辑器去编辑这个数据，同时提供一个解析器去解析该数据，然后渲染出页面，流程如下。

数据结构通过上面的图看到每个页面是由很多节点组成（node）,每个节点可以嵌套子节点。而每个节点包括的基本信息如下，备注文章后续提到的 nodeInfo 都是该节点对应的如下数据

{
  "id": "truck/button1l",
  "type": "truck/button",
  "label": "按钮1l",
  "version": "0.1.4",
  "visible": true,
  "style": {
      "position": "absolute",
      "width": "100px",
      "height": "40px"
  },
  "animate": [],
  "props": {
      "text": "输入文字",
      "type": "danger",
      "click": []
  },
  "path": "https://ymm-maliang.oss-cn-hangzhou.aliyuncs.com/truck/button/0.1.4/index.js",
  "script": "",
  "events": []
}

每个组件比较核心的元素由如下几部分组成

上图的页面包括一个图片，图片下面两个文字，图片兄弟节点有个按钮元素。对应页面的详细数据结构如下，可以感受下完整结构。

{
  "id": "node",
  "type": "node",
  "visible": true,
  "style": {
  },
  "props": {},
  "child": [
      {
          "id": "truck/image15j",
          "type": "truck/image",
          "label": "图片15j",
          "version": "0.1.4",
          "visible": true,
          "style": {
              "position": "absolute",
              "width": "320px"
          },
          "animate": [],
          "props": {
              "url": "https://ymm-maliang.oss-cn-hangzhou.aliyuncs.com/ymm-maliang/access/ymm_1533366999689.png",
              "click": []
          },
          "path": "https://ymm-maliang.oss-cn-hangzhou.aliyuncs.com/truck/image/0.1.4/index.js",
          "script": "",
          "events": [],
          "child": [
              {
                  "id": "truck/text3l",
                  "type": "truck/text",
                  "label": "文本3l",
                  "version": "0.1.4",
                  "visible": true,
                  "style": {
                      "position": "absolute"
                  },
                  "animate": [],
                  "props": {
                      "text": "文字内容1",
                      "click": []
                  },
                  "path": "https://ymm-maliang.oss-cn-hangzhou.aliyuncs.com/truck/text/0.1.4/index.js",
                  "script": "",
                  "events": []
              },
              {
                  "id": "truck/text3l5g",
                  "type": "truck/text",
                  "label": "文本3l",
                  "version": "0.1.4",
                  "visible": true,
                  "style": {
                      "position": "absolute",
                      "width": "114px"
                  },
                  "animate": [],
                  "props": {
                      "text": "文字内容2",
                      "click": []
                  },
                  "path": "https://ymm-maliang.oss-cn-hangzhou.aliyuncs.com/truck/text/0.1.4/index.js",
                  "script": "",
                  "events": []
              }
          ]
      },
      {
          "id": "truck/button1l",
          "type": "truck/button",
          "label": "按钮1l",
          "version": "0.1.4",
          "visible": true,
          "style": {
          },
          "animate": [],
          "props": {
              "text": "输入文字",
              "type": "danger",
              "click": []
          },
          "path": "https://ymm-maliang.oss-cn-hangzhou.aliyuncs.com/truck/button/0.1.4/index.js",
          "script": "",
          "events": []
      }
  ],
  "script": [],
  "animate": [],
  "version": "0.1.0",
  "events": []
}

一句话小结：页面是由很多节点递归生成，每个节点包含布局，事件，脚本，参数，版本等信息，然后编辑器编辑这些信息，解析器解析这些信息。

组件设计

一个页面都是由一个个递归嵌套的组件组成，组件是整个项目的最核心的一部分，为了让组件具有扩展能力，我们对组件的功能使用了 mixin 方式，通过基础组件逻辑+自定义脚本的形式来生成组件。下面介绍下整体组件结构和初始化流程，方便理解我们是如何实现的。

上图左部分可以看到整个页面都是由一个一个node节点组成，他们是一个树状结构，每个node节点下面包含着一个组件对象做功能展示，下面是node节点的dom结构，可以看到每个节点都是递归节点，每个节点内部都包含一个动态组件，每个动态组件的通过nodeinfo.id为key的组件进行渲染。

<div class="node" v-show="visible"  :style="nodeInfo.style">
    <component :is="nodeInfo.id" v-bind="nodeInfo.props" :ref="nodeInfo.id" :style="componentStyle"></component>
    <node v-if="nodeInfo.child" :info="item" v-for="item in nodeInfo.child " :key="item.id"></node>
  </div>

上图右部分可以看到渲染流程。为了达到组件的高扩展性，每个组件的功能包含两个主要部分

一个节点的逻辑功能=组件逻辑+脚本1+脚本2+脚本3... 每个组件在根据自己的类型加载对应js脚本后，会对该组件 nodeInfo.script 里面的逻辑进行mixin. 然后创建一个最终的组件注册到Vue.component 里面方便后续使用,核心代码如下

// 通过加载到的组件脚本获得的全局对象创建vue对象 window['image_1.0.3'] load组件脚本运行后会生成的对象
var component = Vue.extend( window['image_1.0.3']) 
// 遍历所有加入的脚本混合组件对象中
nodeInfo.script.forEach((value)=>{
    component =component.extent(value)
})
// 以节点id为key，注册最终组件对象
Vue.component(nodeInfo.id,component)
// 修改该节点的动态组件 :is 参数为 该节点id
// done

一句话小结：通过不断的mixin新的自定义脚本进来扩展组件能力

组件属性编辑设计

属性编辑主要目的是开发组件的人会暴露一些可配置的参数给运营人员在编辑器里面填写和修改。比如选择一个组件后再右侧属性面板可以对这个组件进行一些属性设置.

为了便于维护和扩展，我们觉得一个组件的可配置数据包括简单数据，复杂逻辑数据，对应可编辑属性的部分也分为两部分

下面针对这两块比较核心的内容说明下我们如何做的。

编辑器基础属性编辑能力

对于一个组件的开发者来说，一是定义该组件那些参数需要暴露到编辑器让运营操作，二是定义该属性对应的值通过什么控件操作。上文在整体架构数据结构中提到了每个node节点都有一个 props 属性，该属性就是存放着该组件可配置的参数所配置的最终值，在初始化组件的时候会把这个 props的数据传入组件进行初始化。而定义一个组件能接受那些参数则是在每个Vue组件的props 属性上定义，而编辑器的作用就是通过编辑器去获取到每个对象定义的props，然后根据每个参数的类型提供不同的编辑控件，比如 boolean 我们会提供切换按钮，image 我们会提供选择图片控件等等。扩展脚本同样可以扩展组件的可编辑属性，下面是一个扩展脚本的例子。主要说明支持的那些类型，可定义的格式。整体流程如下。

下面我们先看一下每个组件可定义的props 例子。

/**
 * 
 * @param type: 字段类型，支持原生类型以及【码良输入类型】
 * 
 * 码良输入类型: 
 * input    单行输入框
 * text     多行输入框
 * enum     列表单选    需提供选项字段defaultList， 支持数组、map结构
 * image    图片选择
 * audio    音频选择
 * video    视频选择
 * richtext 富文本 
 * number   数字
 * function 方法设置
 * data     json数据
 * date     时间选择
 * checkbox 多选框      同enum 不提供defaultList字段时，输入值为布尔类型
 * radio    单选框      同enum
 * 
*/

return {
  props: {
    // 原生类型
    foo: {
      type: String
    },
    // 图片输入
    fooImage: {
      type: String,
      editer: {
        type: 'image'
      }
    },
    // 日期
    fooDate: {
      editer: {
        type: 'date'
      }
    },
    // checkbox 多选
    fooCheckbox: {
      type: Array, // 此项必须为Array
      default: () => { // 且需提供初始值
        return [] // ['day', 'hour', 'min', 'sec']
      },
      editer: {
        label: '显示精度',
        type: 'checkbox',
        defaultList: [ // array 形式的选项
          'day',
          'hour',
          'min',
          'sec',
        ]
      }
    },
    // checkbox 布尔
    fooCheckboxBool: {
      type: Boolean, // 此项必须为Boolean
      editer: {
        type: 'checkbox'
      }
    },
    // enum 含选项
    fooEnum: {
      default: 'value1',
      type: String,
      editer: {
        label: '我是字段名', // 将字段名显示为可读性更强的文本，不提供此项时，显示字段名
        desc: '我是帮助文本', // 为字段提供提示信息，帮助理解字段的意义
        type: 'enum',
        defaultList: { // map结构的选项 key为值，value为显示文本
          'value1': '条件1',
          'value2': '条件2',
          'value3': '条件3',
        }
      }
    },
    // 条件属性
    ifFoo1: {
      type: [Number],
      default: 0,
      editer: {
        work: function () {
          return this.fooEnum == 'value1' // 只有当 `fooEnum` 字段取值为 'value1' 时才显示此项
        },
        label: '条件属性1',
        type: 'number',
      }
    },
    ifFoo2: {
      type: [Date, String],
      default: null,
      editer: {
        work: function () {
          return this.fooEnum == 'value2' // 只有当 `fooEnum` 字段取值为 'value2' 时才显示此项
        },
        label: '条件属性2',
        type: 'date',
      }
    },
  },
  mounted: function () {
    console.log('hello ' + this.foo)
    console.log('hello ' + this.fooImage)
    // ...
  }
}

上面脚本扩展的组件对应的增加的可配置的属性如下图。

这里面的的主要设计在于每个props属性里面添加了一个 editer字段进行该字段在编辑器环境下提供什么组件对该属性进行编辑。editer的字段主要包括如下。

{

    label: '我是字段名', // 将字段名显示为可读性更强的文本，不提供此项时，显示字段名
    desc: '我是帮助文本', // 为字段提供提示信息，帮助理解字段的意义
    type: 'enum',
    ignore: true,       // 不在编辑器显示
    work:function(){
        // 如果满足什么条件才会显示
    },
    defaultList: { // map结构的选项 key为值，value为显示文本
     'value1': '条件1',
     'value2': '条件2',
     'value3': '条件3',
   }
 }

一句话小结：编辑器通过获取每个组件的props，遍历每一个属性，按类型提供不同的操作控件，编辑生成最终的数据放到 nodeInfo.props上。

扩展编辑属性能力

很多时候一个组件可配置的属性按我们的规划来说就下面几种类型。

/**
 * 
 * @param type: 字段类型，支持原生类型以及【码良输入类型】
 * 
 * 码良输入类型: 
 * input    单行输入框
 * text     多行输入框
 * enum     列表单选    需提供选项字段defaultList， 支持数组、map结构
 * image    图片选择
 * audio    音频选择
 * video    视频选择
 * richtext 富文本 
 * number   数字
 * function 方法设置
 * data     json数据
 * date     时间选择
 * checkbox 多选框      同enum 不提供defaultList字段时，输入值为布尔类型
 * radio    单选框      同enum
 * 
*/