最近接到一个需求,要做一个流程设计的功能,大概长下面这个样子:
支持添加、编辑和删除节点,节点只有四种类型:开始节点、普通节点、分支节点、结束节点。
因为每个节点只有一个进和一个出,且节点不需要支持拖拽,连线也是自动连接,所以整体比较简单,不用开源库,自己做的成本也不会很高。
初看其实比较麻烦的只有布局和连线,布局因为节点不需要支持拖拽,所以位置都是自动且固定的,更精确点说其实就是垂直居中,说到居中,你可能会想到flex
布局,那么这里能不能使用flex
布局呢,显然是可以的,另外连线通常可能会使用svg
,但是其实直接使用div
和伪元素也完全可以实现。
接下来我们就从零来实现一下,因为我们的项目原因,所以还是会基于Vue2
版本来实现。
数据结构
整体数据是一个数组,数组的每一项代表一个节点。
开始节点
{ id: 'startEvent', type: 'start', title: '开始' }
id
除了开始和结束节点外,其他节点的id
随机生成即可,type
代表节点的类型,title
为节点的标题。
结束节点
{ id: 'endEvent', type: 'end', title: '结束' }
普通节点
{
id: '随机id',
type: 'normal',
title: '审批人',
content: '主管',// 节点内容
configData: {},// 节点配置数据
nodeList: []// 后续节点
}
默认title
和content
的内容会在节点上显示,而针对每个节点的配置数据保存在configData
上,一般情况下,顶层节点会直接作为数组的一项,而当处于条件分支中时,则需要把后续节点保存在nodeList
上。
分支节点
{
id: '随机id',
type: 'condition',
title: '条件分支',
children: [// 分支
// 普通节点
]
}
分支节点的分支保存在children
属性上,每个分支节点其实就是一个普通节点,普通节点里又可以嵌套分支节点。
布局
入口组件
首先创建一个入口组件:
流程数据通过props
传入,循环数据渲染 Node
组件,Node
组件为所有节点组件的容器。
css
中给sfcContent
元素设置的display: flex;align-items: center;
很关键,就是这两行样式,使得所有顶层节点可以水平排列并垂直居中。
基础组件Node
这个组件作为所有节点组件的容器,只要根据类型渲染不同节点组件即可:
开始节点StartNode、结束节点组件EndNode
开始节点和结束节点差不多,除了样式稍微有点差别外,就是开始节点有根指向下一个节点的箭头线。
开始节点组件:
{{ data.title }}
箭头线下一个小节再看,节点的基础样式因为不影响布局所以也没贴出来。
结束节点组件:
{{ data.title }}
普通节点组件NormalNode
{{ data.title || '' }}
sfcNormalNodeWrap
元素渲染节点自身的内容,如果当前节点的nodeList
中有后续节点,那么遍历递归渲染Node
节点。
通过在容器上设置display: flex
样式,让节点自身内容和后续其他节点水平排列显示,再通过align-items: center
样式让它们垂直居中对齐。
分支节点组件ConditionNode
分支节点自身其实没有实际内容,只是作为一个容器来渲染childen
中的具体分支节点,分支节点其实就是普通节点,所以遍历渲染Node
组件传入数据即可。
到目前为止所有节点组件就已经创建完毕了,传入数据看一下现在的效果:
可以看到大体上已经成型了,只要连上线就大功告成了。
连线
箭头组件
箭头线的样式其实是一样的,所以我们创建一个箭头线的组件ArrowLine
:
线使用before
元素绘制,箭头三角形使用after
元素绘制。
开始节点添加箭头
首先在开始节点中引入箭头组件:
{{ data.title }}
效果如下:
箭头应该在右边,很简单,flex
大法:
普通节点添加箭头
同样先引入箭头组件:
{{ data.title || '' }}
同样需要设置成flex
布局:
分支节点添加箭头
和分支节点列表并列,同样少不了flex
样式:
到这里整体的效果如下:
离胜利只有一步之遥了。
完善分支节点的连线
首先给分支节点加个间距,现在都挨着一起:
连接分支整体的竖线
需要添加如下的竖线:
仔细观察可以发现其实就是给分支节点的前后各添加一竖线,其中的间距其实是因为前面我们给分支节点的每个节点都设置了一个30px
的padding
,但是其实尾部的间距是不需要的:
所以我们修改一下,把右内边距设为0
:
你可能会想直接在分支节点的容器元素sfcConditionNodeContainer
上直接前后绘制两条线,但是问题是这根线不是100%
和容器元素一样高的,而是延伸到最外侧两个分支的高度的一半,通过纯css
其实很难绘制出来,所以我们可以换种方法,让每个分支自己来绘制,这样其实就把一根线分成几段:
具体来说,就是最外侧的两个分支画一根一半高度的线,中间的分支画一根和高度一样的线。
要添加的线比较多,伪元素不够用,所以我们通过div
元素来作为连线,然后通过绝对定位来显示。
效果如下:
连接分支整体和分支的水平线
画完了竖线,接下来是水平线,如下所示,我们要连接分支左侧竖线和分支节点:
这根线的宽度其实就是padding
的大小,然后left
为0
,top
为50%
,同样使用div
来绘制:
连接较短分支和分支整体右侧的水平线
最后还剩下如下图所示的较短分支和分支整体右侧的水平线:
这个也很简单,在每个分支的节点后面添加一个div
作为连线,和分支节点作为兄弟节点,父级设置flex
布局,连线宽度自适应即可:
到这里,节点布局以及连线都已完成,最终效果如下:
是不是很简单。
新增、编辑、删除节点
新增节点
新增节点首先需要在每一个节点后面的连接线上添加一个按钮,点击按钮后选择要添加的节点的类型,然后进行添加。
除了分支节点外,只能添加普通节点,但是对于流程设计的业务来说,可以细分为很多类型,比如审批人、抄送人、发送短信等等,这个不同的业务可能不一样,所以肯定不能写死,需要开放出来可自定义。
首先创建一个添加节点的按钮组件:
按钮组件绝对定位,宽度和箭头线宽度一致,为65px
,高度100%
,和节点一致,相当于覆盖在箭头线上,然后通过flex
布局让真正的按钮居中即可。
先给普通节点加上:
接下来给每个分支也加上:
按钮默认都显示可能不太好看,可以隐藏起来,鼠标滑入按钮组件区域再显示。
然后当鼠标移入按钮时显示可添加的节点类型,点击要添加的节点类型后进行添加。添加一个节点其实就是往数组里插入一项,但不同的节点对应的数组是不一样的,如下图所示:
顶层节点添加下一个节点需要把节点插入顶层数组,分支里的节点插入下一个节点需要插入到自己的nodeList
数组里,所以实现时需要区分一下。
当然分支也是可以添加条件的:
点击后往分支节点的children
数组里添加一项即可。
效果如下:
编辑
编辑主要是当点击某个节点以后可以修改节点标题,节点配置,节点显示的内容一般也是来自节点的配置。
所以对于库来说只要抛出一个点击事件即可,具体的编辑界面用户可根据业务自行开发。
删除
当鼠标悬浮到节点内容上显示一个删除按钮,点击后删除掉当前节点即可,对于条件分支来说,如果删除到仅剩一个分支,那么这个条件分支也就没有了意义,直接整个条件分支自动删除。
自定义节点内容
因为组件树层级比较深,所以通过slot
自定义节点内容不是很方便,所以我选择了一个比较low
的方式,即将节点内容单独抽成一个组件,然后在注册组件的时候提供选项配置,那么如果想自定义节点内容,很简单,不要使用内置的节点内容组件,自行编写并注册一个即可,使用约定的组件名称就可以了。
const install = function (Vue, { notRegisterNodeContent } = {}) {
Vue.component(ConditionNode.name, ConditionNode);
Vue.component(EndNode.name, EndNode);
Vue.component(Node.name, Node);
Vue.component(NormalNode.name, NormalNode);
Vue.component(StartNode.name, StartNode);
Vue.component(Index.name, Index);
// 需要自定义节点内容时通过选项参数指定不要注册内置节点内容组件即可
if (!notRegisterNodeContent) {
Vue.component(NodeContent.name, NodeContent);
}
};
export default {
install
};
然后自己编写一个内容节点并注册:
Vue.component(CustomNodeContent.name, CustomNodeContent)
Vue.use(SimpleFlowChart, {
notRegisterNodeContent: true
})
同样添加节点悬浮面板也可以通过这种方式自定义。
垂直排列
支持垂直排列也很简单,基本上只要在所有设置了display:flex
的地方加上flex-direction: column;
,然后再把连线由竖的改成水平的,位置调一下就可以了:
最后
本文详细的介绍了一下如何使用flex
布局实现一个简单的流程设计器,demo
及完整的源码如下: