jointJS系列之一:jointJS的的初步使用

一、jointJS简介

jointJS是一个基于svg的图形化工具库,在画布上画出支持拖动的svg图形,而且可以导出JSON,也能通过JSON配置导入直接生成图形。

可以基于jointJS开发出流程图、UML图以及图表等。由于jointJS是基于svg的,因此对svg有一定的了解会对jointJS的理解和使用有较大帮助。

由于jointJS是基于backbone的,因此有view(视图)和model(模型)的概念。

使用jointJS需要引入jQuery、backbone、lodash以及jointJS的包,可以通过script标签引入,也可以通过npm安装。

<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/3.10.1/lodash.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/backbone.js/1.3.3/backbone.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jointjs/2.1.0/joint.js"></script>
![arch.png][1]

jointJS的核心概念有三个,每个概念分别对应view和model两种概念(前后分别是model和view概念):元素(element,elementView)、连线(link,linkView)、画布(graph,paper)。

这三个概念之间的关系如上图所示,分别有model和view的概念,我们可以通过改变model的配置,从而改变页面画布的显示。

也能通过页面上的操作,触发view的事件,通过回调函数获取model,进行想要的操作。

jointJS中,视图和模型是分离的,不同概念的模型和视图之间是不能发生联系的,比如把元素添加到画布上,可以使用element.addTo(graph) 或者 graph.add(element) ,但是不能使用element.addTo(paper)这样的操作,因为element是model概念,而paper是视图概念,两者不能直接操作。

接下来介绍比较关键graph、paper、element、link.

1.graph

画布的model概念,创建一个可以挂载的画布,作为图形的容器。通过joint.dia.Graph实例化生成。
        let graph = new joint.dia.Graph;   

2.paper

画布的view概念,由graph挂载在页面的某个dom上生成,是页面上的图形操作区域。通过joint.dia.Paper实例化,传入配置生成。

        let paper = new joint.dia.Paper({
            // 挂载的dom元素
            el: document.getElementById('container'),
            // 关联声明的graph
            model: graph,
            width: 600,
            height: 100,
            gridSize: 1
        });

3.element

元素的model概念,就是图形显示的主体,可以有各种不同的形状,jointJS预设有常用的矩形、椭圆、平行四边形等。除了joint预设的形状以外,我们还可以自定义图形。

元素在实例化时可以配置多种属性,比如元素的大小、在画布中的位置、线条粗细、颜色、填充颜色、文字内容、字体大小等。

元素通过实例化joint.shapes.standard.xxx(xxx是指图形的种类,如Rectangle等),传入配置生成,也可以在自定义的构造方法中传入参数生成(此处代码示例是通过实例化joint预设的形状生成元素),然后添加到graph上。

        // 实例化rect
        let rect = new joint.shapes.standard.Rectangle();
        
        // 设置rect的位置和大小
        rect.position(100, 30);
        rect.resize(100, 40);
        
        // 设置rect的主体颜色和标签样式
        rect.attr({
            body: {
                fill: 'blue'
            },
            label: {
                text: 'Hello',
                fill: 'white'
            }
        });
        
        // 将rect添加到画布上
        rect.addTo(graph);
        
        //克隆生成另一个rect,并添加到画布上
        let rect2 = rect.clone();
        rect2.addTo(graph);     
        

4.link

连线的model概念,是表示图形之间的连接关系的工具,也有joint预设和自定义两种,目前只介绍默认的link。

元素通过实例化joint.shapes.standard.Link或者joint.dia.Link,传入配置生成,也可以在自定义的构造方法中传入参数生成,然后添加到graph上。

        // 实例化link
        let link = new joint.shapes.standard.Link();
        // 设置link的起始元素
        link.source(rect);
        // 设置link的指向元素
        link.target(rect2);
        // 将link添加到画布上
        link.addTo(graph); 
        
    原文作者:Yukai
    原文地址: https://segmentfault.com/a/1190000015972176
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞