[原]JointJS流程图

时间 2020-07-07

原文原文链接

　　最近项目上须要用流程图来作问题定界分析，以前有同事用jsPlumb作过，可是阅读代码后以为比较麻烦，因此本身又找了一圈，找到一个叫Dagre-D3的开源类库，画出来的效果以下图，Dagre-D3最大的优势就是能够实现自动布局，你只须要put数据就能够了，可是缺点就是自动布局后的连线会比较乱，并且连线不是横平竖直的，对于流程图不复杂的还好，稍微复杂点画出来的连线就无法看。最后仍是被pass了。css

jsPlumb地址：https://jsplumbtoolkit.comhtml

Dagre-D3 Git地址：https://github.com/cpettitt/dagre-d3jquery

　　后面通过一番百度，最终决定用JointJS，官网：www.jointjs.com，相比Dagre-D3和jsPlumb，JointJS的API很详细，代码量少，链接线有多种选择，封装了多种经常使用的形状，并且能画的图不少，官方也给了一些demo能够参考。下面是我用JointJS画出来的流程图：git

依赖：在官网的下载页面都能找到github

<link rel="stylesheet" type="text/css" href="joint.css" />
<script src="jquery.min.js"></script>
<script src="lodash.min.js"></script>
<script src="backbone-min.js"></script>
<script src="joint.js"></script>

个人demo里还引用了bootstrap的依赖用来显示模态框json

html代码bootstrap

<body>
    <div id="paper" class="paper"></div>
    
    <div class="modal fade searchpanel" id="detailModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">
      <div class="modal-dialog" role="document">
        <div class="modal-content">
          <div class="modal-header">
            <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
            <h4 class="modal-title" id="modalTitle">详细信息</h4>
          </div>
          <div class="modal-body">

          </div>
          <div class="modal-footer">
            <button type="button" class="btn btn-default" data-dismiss="modal">关闭</button>
          </div>
        </div>
      </div>
    </div>
</body>

js代码数据结构

首先是定义画板和画布，这里重写了ElementView和LinkView，目的是为了让画出来的流程图不能被删除和编辑app

    var graph = new joint.dia.Graph();

    var ElementView = joint.dia.ElementView.extend({
        pointerdown: function () {
            this._click = true;
            joint.dia.ElementView.prototype.pointerdown.apply(this, arguments);
        },
        pointermove: function(evt, x, y) {
            this._click = false;
            joint.dia.ElementView.prototype.pointermove.apply(this, arguments);
        },
        pointerup: function (evt, x, y) {
            if (this._click) {
                // triggers an event on the paper and the element itself
                this.notify('cell:click', evt, x, y); 
            } else {
                joint.dia.ElementView.prototype.pointerup.apply(this, arguments);
            }
        }
    });
    var LinkView = joint.dia.LinkView.extend({
        addVertex: function(evt, x, y) {},
        removeVertex: function(endType) {},
        pointerdown:function(evt, x, y) {}
    });
    
    //定义画布
    var paper = new joint.dia.Paper({
        el: $('#paper'),
        width: 1200,
        height: 600,
        gridSize: 1,
        model: graph,
        elementView: ElementView,
        linkView:LinkView
    });
    //paper.$el.css('pointer-events', 'none')//去除默认样式，使全部事件不可用

而后我写了两个函数分别用来建立形状和连线，这样写能够减小代码量，官方的demo也大都是这样写的jsp

    //定义形状
    var state = function(x, y, shape, background, text){
        var cell;
        if(shape==="rect"){
            cell = new joint.shapes.basic.Rect({
                position: { x: x, y: y },//坐标
                size: { width: 140, height: 40 },//宽高
                attrs: { 
                    rect: {
                        fill: {
                            type: 'linearGradient',
                            stops: [
                                { offset: '0%', color: background },//渐变开始
                                { offset: '100%', color: '#fe8550' }//渐变结束
                            ],
                            attrs: { x1: '0%', y1: '0%', x2: '0%', y2: '100%' }
                        },
                        stroke: background,//边框颜色
                        'stroke-width': 1//边框大小
                    },
                    text: { text: text } //显示文字
                }
            });
        } else if(shape==="ellipse"){
            cell = new joint.shapes.basic.Ellipse({
                position: { x: x, y: y },//坐标
                size: { width: 140, height: 40 },//宽高
                attrs: { 
                    ellipse: {
                        fill: {
                            type: 'linearGradient',
                            stops: [
                                { offset: '0%', color: background },//渐变开始
                                { offset: '100%', color: '#FFFFFF' }//渐变结束
                            ],
                            attrs: { x1: '0%', y1: '0%', x2: '0%', y2: '100%' }
                        },
                        stroke: background,//边框颜色
                        'stroke-width': 1//边框大小
                    },
                    text: { text: text } //显示文字
                }
            });
        }
        graph.addCell(cell);
        return cell;
    };
    
    //定义连线
    function link(source, target, label){
        var cell = new joint.dia.Link({ 
            source: { id: source.id },
            target: { id: target.id },
            labels: [{ position: 0.5, attrs: { text: { text: label || '', 'font-weight': 'bold' } } }],
            router: { name: 'manhattan' },//设置连线弯曲样式 manhattan直角
            attrs: {
                '.connection': {
                    stroke: '#333333',//连线颜色
                    'stroke-width': 2//连线粗细
                },
                '.marker-target': {
                    fill: '#333333',//箭头颜色
                    d: 'M 10 0 L 0 5 L 10 10 z'//箭头样式
                }
            }
        });
        graph.addCell(cell);
        return cell;
    }

最后就是咱们实际的业务代码了，这里咱们能够整理一下数据结构，把数据定义成json格式，而后写一个函数经过json直接生成流程图，固然坐标须要寻找规律本身计算一下

    //建立元素
    var start = state(500,100,"ellipse","#00FFFF", "视频播放成功率");
    var state1 = state(500,200,"rect","#f7a07b", "GET响应成功率");
    var state2 = state(400,300,"rect","#f7a07b", "HTTP错误码分析");
    var state3 = state(600,300,"rect","#f7a07b", joint.util.breakText("TCP异常和其余缘由",{width:80}));
    var state4 = state(400,400,"rect","#f7a07b", "4XX、5XX分析");
    var state5 = state(600,400,"rect","#f7a07b", "接口以上分析");
    var state6 = state(750,400,"rect","#f7a07b", "接口如下分析");
    
    //建立连线
    link(start, state1, "");
    link(state1, state2, "≥70%");
    link(state1, state3, "<70%");
    link(state2, state4, "");
    link(state3, state5, "是");
    link(state3, state6, "否");
    
    //给全部元素添加点击事件
    paper.on('cell:click', function (e) {
        $("#detailModal .modal-body").html("");
        var arr = $("#"+e.id+" tspan");
        if(arr.length===1){
            $("#detailModal .modal-body").append($(arr).html());
            $("#detailModal").modal();
        } else{
            var tmp="";
            $.each(arr, function(k,v){
                tmp+=$(v).html();
            });
            $("#detailModal .modal-body").append(tmp);
            $("#detailModal").modal();
        }
        
    });

后面是给每一个元素（不包含连线）添加了一个点击事件，弹出一个模态框，显示当前点击的内容。