GoJS API 文档

节点是可以通过线连接到其他节点的零部件，也可以是组的成员.

组 继承自节点,允许节点在逻辑上包含其他节点和线.

有关如何定义节点的详细讨论，请参阅节点介绍.

通过Diagram.add可以创建节点将其添加到图表中,且不更新模型.
更常见的用法是通过Model.addNodeData将节点数据对象添加到模型中来创建节点,例如:

  myDiagram.startTransaction("make new node");
  myDiagram.model.addNodeData({ key: "Omega" });
  myDiagram.commitTransaction("make new node");

这将创建一个节点或简单的零部件(复制从Diagram.nodeTemplateMap中找到的模板 ), 在某个Layer 层中添加到图表(基于Part.layerName),并绑定到节点数据(生成 Panel.data作为该节点数据对象的数据. 如果您没有保留对该JavaScript对象的引用,您可以通过调用Model.findNodeDataForKey来查询节点数据.

一般都是通过包含模型中所需属性的JavaScript数组来设置Model.nodeDataArray初始化图表,几乎所有的示例都执行这种初始化.

你可以通过调用 Diagram.remove或者 Model.removeNodeData来删除节点. removeNodeData会修改模型; 如果节点是从模型数据创建的,Diagram.remove也会这么处理. 例如 CommandHandler.deleteSelection（删除选中)的命令会在事务中调用这些方法.

通过调用 findLinksConnected,可以找到与节点连接的所有线. 因为链接线通常有一个方向，所以您可以通过调用findLinksInto将其Link.toNode作为方向,查出该节点这个方向的所有线. 同样的, 你也可以通过 findLinksOutOf 来查找来自某个节点的所有链接线; 这些链接的Link.fromNode就是这个节点. 对于树结构图,则使用 findTreeChildrenLinks or findTreeParentLink.

如果您想知道节点连接的的另一端的节点，则可以调用findNodesConnected返回与给定节点连接的线另一端的所有节点。findNodesInto和findNodesOutOf返回这些节点的子集，只考虑那些进入或离开给定节点的链接线。对于树结构图，则使用findTreeChildrenNodes or findTreeParentNode.

例如，对所有目标节点的数据进行操作:

var it = somenode.findNodesOutOf();
while (it.next()) {
  var child = it.value;
  if (child.data.text.indexOf("special") >= 0) { ... }
}

您可以通过创建一个新链接,设置它的Link.toNode 和Link.fromNode(按任意顺序)并通过Diagram.add添加到图表中。
但是更为常见的方式是通过调用GraphLinksModel.addLinkData将线数据对象添加到图表模型中.仅仅创建和添加链接不会更新模型. 因此，要在使用GraphLinksModel时添加线，应该这样做:

  myDiagram.startTransaction("make new link");
  myDiagram.model.addLinkData({ from: "Alpha", to: "Beta" });
  myDiagram.commitTransaction("make new link");

在这里，您可以用线替换要连接的实际节点的key. 如果使用的是TreeModel，则不存在任何链接线数据对象,TreeModel.setParentKeyForNodeData 来为"child"子节点数据指定"parent"父节点的key。

在GraphLinksModel中通过线数据对象查找线，请调用Diagram.findLinkForData。当使用TreeModel时，调用Diagram.findNodeForData 或 Diagram.findNodeForKey来获取节点，然后调用findTreeParentLink来获取链接线(如果存在线的话).

要找到连接两个节点的线，请调用findLinksTo 或 findLinksBetween。对于前一种方法，方向很重要;使用后一种方法，它在任何方向返回链接。

如果你想在线与节点连接或断开连接时，改变节点的外观。可以将linkConnected 和 linkDisconnected属性设置为被调用的函数，在回调函数中改变节点外观。注意在回调函数中不能修改任何链接线关系——属性的存在只是为了更新节点的外观。一个典型的用法是改变形状的颜色或形状。

可以通过LinkingBaseTool.isValidLink的结果来控制用户是绘制一个新链接线还是重新连接两个节点之间的线。您可以在LinkingTool 和 RelinkingTool上重写该逻辑，但是设置linkValidation or LinkingBaseTool.linkValidation 函数属性更容易。

有关验证的更一般讨论，请参阅验证介绍 Introduction to Validation。 验证介绍.

节点还支持在节点上使用的“线端口(port)”作为线的接入点，并提供逻辑和物理特性（拖动创建线等）. 默认情况下，线端口对象是整个节点. 但是,你可以在节点任何一个可视的图形对象上定义GraphObject.portId 属性，使得这个图形对象被视为端口. "线端口ID(portId)"只是一个字符串，并且在节点的所有端口元素中必须是唯一的.

对于只有一个线端口的节点，应该设置图形对象的portId=""。当没有这样的元素被声明为默认端口时，它将使用整个节点作为端口。您可以使用port属性来获得唯一的port元素。

当一个节点应该有多个端口，即多个图形对象作为链接线的单独连接点时，你应该为每一个图形对象设置一个唯一的端口Id(portId 相对于节点)。可以使用ports属性获得端口的元素集合。也可以使用findPort方法按名称查找特定的端口元素.

注意:GraphLinksModel是唯一一种可以保存端口信息的模型,当portIds不为空字符串时,需要设置GraphLinksModel.linkFromPortIdProperty 和 GraphLinksModel.linkToPortIdProperty属性来使用端口。

有关端口的详情，请参阅端口介绍.

上面提到的所有“findLinks…”和“findNodes…”方法都带有一个可选的端口id参数。当没有传递任何参数时，这些方法将获取与节点连接的所有线。当提供线端口id参数时，这些方法只获取与给定节点中的端口连接的线。因此，在浏览图表时，您可以很容易地查看来自给定节点的对线所指向的所有节点。或者您可以只查看来自特定端口的链接线末端的那些节点。.

您还可以控制每个端口上线的默认连接行为。因为一个端口可以是任何的 图形对象，所以它们都是图形对象上的属性。这些属性是重复的，因此您可以将线的“from”端与链接的“to”端区别开来。属性包括:

• GraphObject.fromSpot, GraphObject.toSpot 设置线连接端口的位置
• GraphObject.fromEndSegmentLength, GraphObject.toEndSegmentLength 设置一段直线到端口的距离
• GraphObject.fromShortLength, GraphObject.toShortLength 设置线到端口的距离
• GraphObject.fromLinkable, GraphObject.toLinkable 设置端口是否允许连入连出
• GraphObject.fromLinkableDuplicates, GraphObject.toLinkableDuplicates 设置端口是否允许重复连接的线
• GraphObject.fromLinkableSelfNode, GraphObject.toLinkableSelfNode 设置端口是否可以自己连自己
• GraphObject.fromMaxLinks, GraphObject.toMaxLinks 设置端口的线连接数量限制

The "...Spot" and "...Length" and "...Direction" 属性控制端口上线连接的位置和路由.
The "...Linkable..." and "...MaxLinks" 属性控制用户是否可以绘制新链接线或将现有线从端口重新连接到端口. (The "...Spot" and "...Length" and "...Direction" 属性也存在于链接线上，以覆盖来自端口元素的特定链接线的默认值.)

更多有关线端口的使用，请参阅线连接点介绍.

当图形是树状结构时，你可以使用几个函数来遍历树::

• findTreeParentNode 获取节点的父节点
• findTreeChildrenNodes 获取节点的子节点集合
• findTreeParentLink 获取节点与父节点之间链接线
• findTreeChildrenLinks 获取节点与子节点之间链接线
• findTreeRoot获取节点所在树的根节点
• findTreeParentChain 获取节点的父亲及祖宗节点集合
• findTreeParts 获取节点的子子孙孙节点集合
• findCommonTreeParent 获取节点的爷爷节点
• isInTreeOf 判断节点是否是子节点
• findTreeLevel 获取节点在树结构中的层级

确定树是通过指向子节点的链接线从根节点开始生长，还是相反，整个图由Diagram.isTreePathToChildren属性控制.但是如果 Link.isTreeLink 为false,则上述函数将忽略单个链接线.

Node类还支持扩展和折叠节点和线的子树的概念，从而显示或隐藏这些节点和线。通过设置Node.isTreeExpanded来实现。当然，如果图表的图不是树结构的，那么这些概念和属性可能就不适用了。

如果你想在折叠和展开时改变父节点的外观，可以在定义 treeExpandedChanged 属性，在它的回调函数中处理，需要注意的是此函数不能修改任何链接关系或展开或折叠任何子树——该属性仅用于更新节点的外观.

有一个线路由定义可以避免线经过节点:Link.routing = Link.AvoidsNodes. 您可以通过设置avoidable属性来控制此类链接线应该避免还是忽略某个节点. 设置avoidableMargin 来控制超出 GraphObject.actualBounds 的区域，在那里AvoidsNodes链接线将绕开不经过

有关更示例，请参见 节点, 端口, and 链接点.

有关树的更多信息，请参见 Trees, and SubTrees.

要自定义用户调整大小的行为，请阅读调整大小工具的介绍 Introduction to the ResizingTool. 要自定义用户旋转行为，请阅读RotatingTool的介绍 Introduction to the RotatingTool.

只有图中的节点才能通过线进行连接。 模板不应该与线连接，不应该是线的标签，不应该是组的成员，也不应该有任何装饰.