关于JointJs的介绍,有一篇比较好 JointJS介绍
属性
el css选择器,Paper将在该Css选择的Container下画SVG图.例如:el=’#paper’,则在
下面添加SVG DOM节点
width paper的宽度
height paper的高度
origin paper原点的坐标,默认{x:0,y:0}
gridSzie 默认为1
model joint.dia.Graph object,根据MVC,该属性对应model,paper对应view
perpendicularLinks 连接线是否正交,默认为false
elementView 负责渲染graph ,默认 joint.dia.ElementView
linkView 负责渲染links,默认 joint.dia.LinkView
defaultLink 用户动态创建的link(比如:从一个port drag 一条线),默认为 joint.dia.Link,也可以是一个返回值类型为 joint.dia.Link函数 function(cellView, magnet) {}
interactive 如果设置为false,则graph中的element和link将禁止操作
validateMagnet(cellView, magnet) magnet翻译成中文就是磁石,在JointJs中它代表的是一个DOM元素,当用户点击magnet时,这个函数判断是否创建Link
validateConnection(cellViewS, magnetS, cellViewT, magnetT, end, linkView)在source view/magnet (cellViewS/magnetS) and target view/magnet (cellViewT/magnetT)之间是否允许链接。
linkConnectionPoint(linkView, view, magnet, reference)
这个函数允许用户指定link在渲染时stick到元素的某个坐标。这个函数返回一个点{x,y}。当然jointJS也给我们提供了一个强大的函数shapePerimeterConnectionPoint
shapePerimeterConnectionPoint joint.util.shapePerimeterConnectionPoint(linkView, view, magnet, ref)使用方式如下:
var paper = new joint.dia.Paper({ ... linkConnectionPoint: joint.util.shapePerimeterConnectionPoint ...})
效果如下:
snapLinks 当为true时,Link会寻找离它最近的元素进行闭合
linkPinning 当为true时,link可以终止于paper,也就是说link可以连接于一个点,而不是element
markAvailable 当用户点击magnet时,界面上显示可以连接的magnet。为了突出可以连接的magnet,添加必要的css
/* port styling */.available-magnet { fill: yellow;}/* element styling */.available-cell rect { stroke-dasharray: 5, 2;}
async
embeddingMode 当为true时,paper改变为embed模式,具体说:用户可以将一个元素拖拽到另一个元素里面。在该模式下,所有的link和element会多一个z属性,就行css中的阴影有一个z属性表示层级。为了控制哪些元素可以embed,需要配置 validateEmbedding()。总之这个属性对于层级图是必须的。
validateEmbedding(childView, parentView) 如果childView允许被潜入到parentView,返回true.默认所有元素都可以embed到其他元素中
restrictTranslate/function(elementView) 当设置为true的时候,用户将不能将elemnt移动到paper边界之外。默认为false。当然它最大的好处不是这个,当给该属性配置一个函数时,你可以限制子元素不可以拖拽出父元素,比如:
restrictTranslate: function(elementView) { var parentId = elementView.model.get('parent'); return parentId && this.model.getCell(parentId).getBBox();}