展开全文

根据你的业务逻辑绘制好流程图，这里的节点包括开始节点（圆形）、分支节点（菱形）和行为节点（矩形）。如下图所示，可以绘制多条执行链，每条执行链都从一个开始节点出发。

完成每个节点的函数编写

依次双击节点，打开代码编辑框，为每个节点编写代码。

前端 js 代码实现包含了同步逻辑和异步逻辑，大多数可以使用同步逻辑实现，但是涉及到接口请求、定时任务等场景时就需要使用到异步逻辑。因此，在 imove 中我们支持书写同步代码和异步代码，并在编译中考虑了这两种情况。具体写法如下所示。

// 异步代码// 写法1 使用promiseexportdefaultfunction( ctx) { returnnewPromise( resolve=> { setTimeout( => resolve, 2000); });}// 写法2 使用async awaitexportdefaultasyncfunction( ctx) { constdata = awaitfetchData; returndata; }

在项目中使用

以上步骤只涉及到绘制流程图、编写节点代码，但是我们需要把这些 js 逻辑代码加入到自己的项目中，才能实现一个完整的项目。为了方便把这些编写的 js 逻辑加入到项目中，我们可以选择以下两种方式引入：1）将 imove 编写的代码在线打包，将打包文件引入到项目中；2）直接在本地启动开发模式 imove -d，可以结合项目进行实时调试，边在 imove 修改边看项目效果。以下介绍两种引入方式的具体步骤：

（1）本地打包出码

点击页面右上方的”导出”按钮后，可以在弹窗内选择“导出代码”，此时流程图编译后的代码将以 zip 包的形式下载到本地，你可以解压后再引入项目中使用。

引入后使用方法如下：

constApp = => { // 引入方法useEffect( => { // 事件监听——在节点代码中，通过`ctx.emit(‘a’)`执行a事件，以下是监听此事件的函数logic.on( ‘a’, (data) => { });// 执行一条流程——触发执行“开始节点”逻辑触发名称为b的那条流程logic.invoke( ‘b’); }, []);return< div> xxx </ div> };

exportdefaultApp;

2）本地启动开发模式

1.安装 @imove/cli

2.进入项目根目录， imove 初始化

3.本地启动开发模式

本地启动成功之后，可以看到原来的页面右上角会显示连接成功。

此时页面上触发“保存快捷键 Ctrl + S”时，就可以看到当前项目的 src 目录下会多出一个 logic 目录，这就是 imove 编译生成的代码，此时你只要在你的组件中调用它即可。调用的方法仍然如本地打包出码中演示的一致。

为什么需要使用流程编排

了解了基于 imove 的开发方式，接下来具体讨论一下为什么需要这么做。试想一下，你有没有遇到过以下场景：

以上这些种种问题，其实是前端开发中或多或少会遇到的痛点。其实，我们可以采用逻辑编排的开发方式，把业务中的一个个功能点按照逻辑顺序组织起来，不仅能够及时检查逻辑漏洞，还能沉淀非常多的业务逻辑，达到参考和复用的效果。以下是总结的采用可视化编排方式进行编程的好处：

（1）需求可视化

把需求按照流程图的方式展示出来，可视化的流程对于新人以及非开发同学来说是非常容易理解的，对了解业务有很大的帮助。特别是在判别条件非常多、业务身份非常多、业务流程冗长而复杂的场景中，能梳理好全部的需求逻辑，能更好地检查代码是否考虑了全部的需求场景。这使得交付、交流、接手会更容易。

（2）逻辑复用

因为代码是针对于节点粒度的，在做需求时，可以参考和复用已有的节点代码（如判断登录、关注店铺等等），不仅对新人上手非常友好，也节约了反复编写重复代码的时间，能缩短开发周期。随着逻辑节点的不断沉淀，这种优势也会越发明显。

（3）提高代码规范

在现有的开发方式下，随着需求不断迭代，可能有会有越来越多的业务逻辑被分散在各个模块中，很可能会违反职责单一、高内聚低耦合的编程原则。而通过逻辑编排的方式开发，每次只针对一个节点编写代码，能保证各个能力职责单一，最后通过聚合的方式串联起整个业务逻辑。

现在思考一下，使用到逻辑编排后，上述列举出的种种问题，是不是会迎刃而解呢？

其实逻辑编排不是一种新出现的思想，其实像我们生活中，都有逻辑编排的影子。它只是按照行为逻辑，把一个个单一的业务行为（如限流、限购、加购等等）有序编织为一个完整流程，聚合成一条具有特定业务含义的执行链，每一个完整的流程都会有一个触发点。如下图，就是在业务场景中整理的流程图：

因此，在 coding 中引入逻辑编排的概念是有价值的，我们也正在尝试着使用新的开发模式去提高生产效率。

2

基于 x6 的流程编排

在上文中详细展示了为什么需要使用到流程编排，下面详细介绍下流程图绘制的原理。imove 底层采用了蚂蚁团队提供的 antv-X6 图编辑引擎 ，从而实现了流程图绘制的能力。

为什么要选用 antv-x6 作为底层绘图引擎呢？因为它基本能覆盖到流程图绘制的全部需求，内置了图编辑场景的常规交互和设计，能帮助我们快速创建画布、节点和边，能够做到开箱即用，使用是非常方便的。它开放了丰富的定制能力给到开发者，只需简单的配置就能实现想要的效果，其不仅仅支持流程图，还支持 DAG 图、 ER 图、组织架构图等等。在 imove 中我们仅仅使用到了流程图绘制的能力，其实 x6 还有更多的能力值得大家去使用去探索。下面结合 imove 框架的实现，详细介绍下我们实现流程图绘制的具体思路，如何从 0 到 1 实现可用的较为完备的流程图绘制能力。

画布设计

使用 x6 创建画布非常容易，实例化一个 x6 暴露的 Graph 对象即可。以下是画布的具体配置项，包括了一下特性。

具体的代码实现如下，注释了各类能力对应的 API 文档，大家有兴趣可以试试~

完成了画布的开发，接下来在主界面中引入即可。这里我们发现还是存在很多问题：

• 无法使用键盘快捷键怎么办，比如复制粘贴保存撤销？
• 想监听一些画布方法怎么办，例如双击节点直接打开编辑框、右键节点打开菜单、右键画布打开另一个菜单？
• 想实现小地图怎么办？
• 想把画布信息导出并储存怎么办？

……

仅仅依赖于以上 new Graph 配置的信息是远远不够的，还需要一步步完善起来。

快捷键设置

根据 键盘快捷键 Keyboard 介绍，Graph 实例会暴露一个 bindKey 方法，我们可以用它来绑定快捷键。以使用频率最高的 ctrl + c / ctrl + v 举例，这里定义了一系列的键盘快捷键和 handler 监听函数，如 ctrl + c 时获取当前选中的元素，利用 copy 方法完成复制操作，ctrl + v 时直接使用 paste({offset:xx}) 方法完成粘贴操作。

首选需要在 new Graph 的参数中加入 keyboard 配置项，这里的 global 代表是否为全局键盘事件，设置为 true 时绑定在 Document 上，否则绑定在画布容器上。在这里我们设置为 false，只在画布获得焦点才触发键盘事件。

接下来要配置支持的快捷键，如复制、粘贴、保存、撤销、缩放、全选……需要指定对应的按键以及监听函数。感兴趣的朋友可以看下 shortcuts.ts。

我们也可以实现快捷键或滚轮放大、缩小的能力，需要自定义每次缩放尺度的改变量，根据当前的缩放尺度去增减这个改变量即可。为了避免用户无限放大或无限缩小带来不好的视觉体验，最好定义一个最大和最小的缩放尺度。

最后我们把所有的快捷键绑定在 Graph 上，即可完成全部快捷点的配置。

画布方法注册

在当前画布上，我们需要监听一系列常用的方法，如双击节点、画布右键、节点右键等等。在 imove 中，完成了以下的操作：

以下是具体的实现方法：

创建画布实例

目前已经完成了画布通用配置、快捷键设置、事件绑定，接下来实现一个 createFlowChart 的工厂函数。在工厂函数中，我们创建了画布实例，并为其注册绑定的事件、注册快捷键、注册服务端存储。

exportdefaultcreateFlowChart;

这样，画布的功能越来越完善了，已经支持绘制流程图了。

导出模型

在 imove 中，需要支持绘制的流程图以 DSL 、代码、流程图的导出，这样在真实业务开发中，就可以最大程度的复用节点和流程。为了实现这个功能，我们实现的相关函数如下。

// 导出代码constonExportCode = => { constzip = newJSZip; constdsl = flowChart.toJSON; constoutput = compileForProject(dsl); Helper.recursiveZip(zip, output);

zip.generateAsync({ type: ‘blob’}).then( ( blob) => { DataUri.downloadBlob(blob, ‘logic.zip’); });};

// 导出流程图constonExportFlowChart = => { flowChart.toPNG( ( dataUri: string) => { DataUri.downloadDataUri(dataUri, ‘flowChart.png’); }, { padding: 50, ratio: ‘3.0’}); };

节点设计

在 imove 中，我们设计了以下三种节点类型：事件节点（开始节点）、行为节点、分支节点。节点负责处理具体的逻辑流程，以下是三种节点的具体描述：

根据上述的规范描述，我们可以绘制出各种各样的逻辑流程图，例如 进入首页 的流程图如下所示：

节点属性结构

imove 的流程图节点需要承载了多种属性，如节点文字、代码、投放配置模型、投放配置数据、依赖包等等，但是在 x6 中，节点的基本属性为 id、 shape、 position、 size，主要包括与 x6 图形展示相关的基本数据，简称为图形化数据。因此我们需要扩展节点属性，这些扩展的属性简称为自定义数据。

1.图形化数据（主要包括与 X6 图形展示相关的基本数据）

• id: 32-bit 唯一标识符
• shape: 形状
• position: {x, y}: 横向 / 纵向位移
• size: {width, height}: 宽高大小
• …

2.自定义数据（扩展的属性）

• type: 节点类型
• label: 节点展示文案
• code: 节点存储的代码
• dependencies: js 代码的依赖包
• trigger: 触发逻辑开始的事件名（开始节点才有）
• ports: 节点出口配置（跳转逻辑，分支节点才有）
• configSchema: 投放配置模型
• configData: 投放配置数据
• version: 版本号
• forkId: 复制来源
• referId: 引用来源

定义完这些节点属性后，就可以实现节点信息的存储，不至于丢失信息。通常来说，信息配置使用频率最高的有：

• 显示名称：更改节点名称
• 逻辑触发名称：开始节点类型专属配置，项目代码使用时根据这个值触发逻辑调用
• 投放配置 schema：修改投放配置的表单结构

这里编辑的每一条信息，都会保存在节点的属性里。

节点拖拽

单纯有画布是不够的，我们还需支持在画布上添加节点：

可以使用 addNode 和 addEdge 方法来动态添加节点和边：

然而这种方式并不能达到通过拖拽来生成流程图的要求，不过也不用担心， x6 已经考虑到了这点，封装了 Dnd 类（drag and drop）来解决这个问题。代码如下：

节点样式设置

为了不限制绘制流程图的体验， iMove 工具栏提供了绘制流程图常用到的一些功能（例如修改字号、加粗、斜体、文字颜色、背景颜色、对齐等等），这主要也是得益于 X6 提供了统一修改节点样式的方法。工具栏如下所示：

使用 setAttrs 方法可以配置指定的样式：

节点代码编写

每个节点的代码等价于一个 js 模块，因此你不用担心全局变量的命名污染问题，甚至可以 import 现有的 npm 包，但最后必须 export 出一个函数。需要注意的是，由于 iMove 天生支持节点代码的异步调用，因此 export 出的函数默认是一个 promise。

就以 是否登录 这个分支节点为例，我们来看下节点代码应该如何编写：

由于该节点是分支节点，因此其 boolean 返回值决定了整个流程的走向。如果是非分支节点，直接流向下一个连接的节点即可。

节点间数据通信

完成节点代码编写之后，我们再来看下节点之间是如何进行数据通信的。

在 iMove 中，数据是以流（pipe）的形式从前往后进行流动的，也就是说前一个节点的返回值会是下一个节点的输入。不过也有一个例外，由于 分支节点 的返回值会是 boolean 类型，因此它的下游节点拿到的输入必将是一个 boolean 类型值，从而造成数据流的中断。为此，我们进行了一定的改造，分支节点的作用只负责数据流的转发，就像一个开关一样，只决定数据流的走向，但不改变流向下游的数据——流入分支节点后一个节点的数据依然是分支节点前一个节点输出的数据。

因此，以下例子中“请求 profile 接口”和“返回数据“两个节点会成为数据流的上下游关系。

我们再来看下他们之间是如何进行数据通信的：

节点: 请求 profile 接口

节点: 接口成功

节点: 返回数据

如上代码所述，每个下游节点可以调用 ctx.getPipe 方法获取上游节点返回的数据流。另外，需要注意的是 返回数据 节点的最后一行代码 ctx.emit(‘updateUI’, data) 需要和项目中的代码配合使用，项目中想监听这个事件，需要执行 logic.on(‘updateUI’,data=>{ //handler })。

边设计

在 imove 中，边的作用被弱化，仅表示图形上的节点连接关系，主要控制流程的走向，使用过程中仅用于连线。因此我们没有额外设计边属性，只采用了 X6 默认的边的属性：id（唯一标识符）、shape（形状）、source（起点）、target（终点）。如下所示：

除了边属性结构描述外，我们还需要关注边连线实现、样式定制化和代码编译，下面会分别讲一下。

边连线实现

边连线是通过在画布上绑定 edge:connected 事件实现的：

if(sourceNode && sourceNode.shape === ‘imove-branch’) { constportId = edge.getSourcePortId;

if(portId === ‘right’|| portId === ‘bottom’) { edge.setLabelAt( 0, sourceNode.getPortProp(portId, ‘attrs/text/text’)); sourceNode.setPortProp(portId, ‘attrs/text/text’, ”); }}});

这些 x6 都已经提供好了，开发和定制都是非常简单。

边选中样式定制化

默认的边是没有选中高亮的样式的，这里我们可以直接在画布上绑定边选中的事件，改变边的样式即可：

如果大家想按照自己的喜好来定制流程图上的边展示，可以非常简单的实现。

基于流程图的代码编译

流程图画好了，我们如何实现完整流程的代码运行呢？其实，流程图对应是的一个 JSON Schema，这样我们就可以根据节点的连接顺序进行编译了：

流程图编译的 Schema 如下所示：

通过流程图 Schema，可以解析到节点属性和节点关系，如开始节点、行为节点如何流向下一个节点，分支节点如何根据运行结果分别流向两条边。具体的编译过程如下所示：

首先根据 DSL 可以获取全部的边（Edge），边的属性上存储了 source 节点和 target 节点的 id 和方向，即起始节点和终点节点的 id 和方向，再根据节点的 id 可以找到全部的节点，于是可以串联起全部的节点和边。这里有几点要注意的是：

按照以上分析的思路，找到当前节点的下一个节点代码如下：

3基于 form-render 的可视化搭建

在电商领域，业务场景会时常涉及到营销表单的配置。因此代码中会暴露出一些字段供运营配置，这些字段需要以合适的表单形式呈现，因此涉及到表单 Schema 结构的定义。iMove 在定义表单 Schema 结构时，是可以使用可视化的方式设计表单结构的，这里得益于 form-render 这个开源项目的优秀设计，我们可以使用其提供的 fr-generator 库，通过可视化拖拽修改的形式快速生成投放表单结构，方便后续进行数据投放。具体效果如下：

如何做到 Schema to Form

以上提到的 fr-generator 表单设计器是如何快速地进行表单搭建的呢？这不得不先说一下如何根据规范化 Schema 转化为 Form。知其然知其所以然，接下来我们看看 form-render 是如何实现这一步的：

接下来讨论下 fr-generator 表单设计器的核心操作是什么。点击左侧表单组件，就可以将其加入到表格中：

以下的 Element 组件即代表左侧每一个表单选项，点击左侧表单组件，会调用 handleElementClick 方法，实际上是调用了 addItem 方法：

addItem 对应的代码实现如下，其实是改变了原有的 JSON Schema 数据， JSON Schema 改变了，中间渲染的表单就会跟随发生变化。核心步骤如下：

数据驱动带来的便利性

其实，类似于 form render、 fomily 这样的库，可以通过简单的 JSON Schema 生成表单，都是基于数据驱动的思想实现的。维护自身的一套 schema 规范，按照规范解析 schema 文件可以直接完成表单的渲染。数据驱动为何让开发者如此热衷？react、 vue 等流行框架的底层也是数据驱动的思维，解放了程序员繁琐重复的工作。

就拿 vue 框架来说，以下数据驱动带来的便利性非常受人欢迎：

在数据驱动的场景下，我们只需要完成两步：

数据驱动的思想能够给前端带来很多的便利。以前开发时，我们处理页面元素就会处理 DOM，处理事件逻辑就会处理 Java，处理样式就会处理 CSS。切换为数据驱动的思想之后，我们可以把页面元素、事件逻辑、样式都视为数据，设计好数据与状态之间的转换关系，通过改变数据直接去改变状态。以上介绍的 x6 和 form-render 都是可以通过已有的规范 JSON 数据，直接生成对应的流程图和表单，其实数据和 UI 的转换关系已经隐藏在了框架的内部实现中。

4总结

这篇文章主要讨论了 imove 基于 X6 和 form-render 背后的思考以及相关的实现原理，主要是在已有开源库的基础上不断去完善，直到满足项目的需求，这样才能做到 ROI 最大化，相互成就。iMove 做的比较好的是定位，继而将写法规范化，将编排工具化，这样克制的设计使得 iMove 具备小而美的特点，便于开发使用。

我们在初次使用某个开源框架或库时可以根据官方文档提供的示例实现 Demo 效果，由于每个人业务需求都不尽相同，可能需要进行不同的配置甚至进行二次开发才能实现。这时候，可以恰当地使用现有的 API 能力去尽量实现需求，如果没有提供相应的能力，也可以看看有没有提供自定义插件、自定义函数或组件能满足需求。如果还是没有合适的方案，或许可以尝试一下自己实现？如果框架体积非常大但是你只需要使用到其中很小一部分，这时候可以考虑下看看对应的源码，学习下原理尝试自己实现，其实 x6 和 form-render 这种开源基础库在很多场景下都是非常实用的。未来 imove 还会持续迭代，喜欢的朋友们欢迎来踩踩哦~

活动推荐

点个在看少个 bug👇