彩票走势图

流程图控件GoJS教程:如何内置GoJS交互性

翻译|使用教程|编辑:杨鹏连|2020-12-09 09:45:29.817|阅读 244 次

概述:GoJS实现了许多常见的编辑操作,例如操纵零件(移动,添加,复制,剪切和删除)。这些编辑功能默认情况下可通过鼠标(或触摸)和键盘访问,也可以在JavaScript中以编程方式调用。

# 慧都年终大促·界面/图表报表/文档/IDE等千款热门软控件火热促销中 >>

相关链接:

GoJS是一款功能强大,快速且轻量级的流程图控件,可帮助你在JavaScript 和HTML5 Canvas程序中创建流程图,且极大地简化您的JavaScript / Canvas 程序。

点击下载GoJS最新版

内置GoJS交互性

GoJS实现了许多常见的编辑操作,例如操纵零件(移动,添加,复制,剪切和删除)。这些编辑功能默认情况下可通过鼠标(或触摸)和键盘访问,也可以在JavaScript中以编程方式调用。

下图定义了一个节点模板,并且在其模型中具有四个节点:

var $ = go.GraphObject.make;
myDiagram =
  $(go.Diagram, "myDiagramDiv",
    { "undoManager.isEnabled": true });

// define a simple Node template
myDiagram.nodeTemplate =
  $(go.Node, "Auto",
    $(go.Shape, "Rectangle",
      // don't draw any outline
      { stroke: null },
      // the Shape.fill comes from the Node.data.color property
      new go.Binding("fill", "color")),
    $(go.TextBlock,
      // leave some space around larger-than-normal text
      { margin: 6, font: "18px sans-serif" },
      // the TextBlock.text comes from the Node.data.key property
      new go.Binding("text", "key"))
  );

myDiagram.model = new go.GraphLinksModel(
[
  { key: "Alpha", color: "lightblue" },
  { key: "Beta", color: "orange" },
  { key: "Gamma", color: "lightgreen" },
  { key: "Delta", color: "pink" }
]);


开箱即用,有几种交互方式可用:

  • 单击一个节点以将其选中。在节点上按并拖动以将其移动。或者按并拖动图背景以平移整个图。
  • 常见的键盘快捷键(例如CTRL-C,,CTRL-V)CTRL-X 将分别复制,粘贴和剪切图部分。
  • 拖动并按住可创建用于选择多个节点的选择框。按住CTRL键并单击节点,可以切换它们的选择。
  • 由于图的undoManager已启用,CTRL-Z因此CTRL-Y将撤消和重做操作。平移(滚动)和选择不被视为不可撤消的操作。
通过设置一些属性,您可以向用户公开更多的交互:
var $ = go.GraphObject.make;
var myDiagram =
  $(go.Diagram, divname,
    {
      // allow double-click in background to create a new node
      "clickCreatingTool.archetypeNodeData": { key: "Node", color: "white" },
      // allow Ctrl-G to group
      "commandHandler.archetypeGroupData": { text: "Group", isGroup: true },
      // have mouse wheel events zoom in and out instead of scroll up and down
      "toolManager.mouseWheelBehavior": go.ToolManager.WheelZoom,
      "undoManager.isEnabled": true // enable undo & redo
    });

myDiagram.nodeTemplate =
  $(go.Node, "Auto",
    $(go.Shape, "Rectangle",
      { stroke: null },
      new go.Binding("fill", "color")),
    $(go.TextBlock,
      { margin: 6, font: "18px sans-serif", editable: true },
      new go.Binding("text", "key"))
  );

// allow CTRL-SHIFT-G to ungroup a selected Group
myDiagram.groupTemplate.ungroupable = true;

myDiagram.model = new go.GraphLinksModel(
[
  { key: "Alpha", color: "lightblue" },
  { key: "Beta", color: "orange" },
  { key: "Gamma", color: "lightgreen", group: "Group1" },
  { key: "Delta", color: "pink", group: "Group1" },
  { key: "Group1", isGroup: true }
]);      


  • ClickCreatingTool.archetypeNodeData 允许在后台双击以创建具有指定数据的新节点。
  • CommandHandler.archetypeGroupData允许CTRL-G对选择的节点进行分组。
  • Group.ungroupable允许CTRL-SHIFT-G取消组合选定的组。
  • ToolManager.mouseWheelBehavior默认情况下允许鼠标滚轮缩放而不是滚动。您可以通过单击鼠标滚轮来切换此属性。在触摸设备上,默认情况下启用捏缩放。
  • TextBlock.editable在TextBlock定义允许文本的地方进行编辑。选择一个节点,然后单击文本,或按F2键开始文本编辑。单击图上的其他任何位置,或按Tab完成文本的编辑。
这些交互(以及更多!)都存在于basic.html示例中。确保还查看有关GoJS命令的“简介”页面。

您可以根据需要允许用户执行的操作来禁用具有某些属性的图交互性的某些部分。有关更多信息,请参见GoJS权限的简介页面。

上下文菜单

GoJS提供了一种机制,您可以为任何对象或图本身定义上下文菜单。在下面的示例中,定义了两个上下文菜单,一个在Node模板上(一个按钮),另一个在图上(两个按钮)。

var $ = go.GraphObject.make;
var myDiagram =
  $(go.Diagram, divname,
    { "undoManager.isEnabled": true });

// this function is called when the context menu button is clicked
function nodeClicked(e, obj) {
  alert('node ' + obj.part.data.key + ' was clicked');
}

// defines a context menu to be referenced in the node template
var contextMenuTemplate =
  $(go.Adornment, "Vertical",
    $("ContextMenuButton",
      $(go.TextBlock, "Click me!"),
      { click: nodeClicked })
    // more ContextMenuButtons would go here
  );

myDiagram.nodeTemplate =
  $(go.Node, "Auto",
    { contextMenu: contextMenuTemplate }, // set the context menu
    $(go.Shape, "Rectangle",
      { stroke: null },
      new go.Binding("fill", "color")),
    $(go.TextBlock,
      { margin: 6, font: "18px sans-serif" },
      new go.Binding("text", "key"))
  );

// this function alerts the current number of nodes in the Diagram
function countNodes(e, obj) {
  alert('there are ' + e.diagram.nodes.count + ' nodes');
}

// this function creates a new node and inserts it at the last event's point
function addNode(e, obj) {
  var data = { key: "Node", color: "white" };
  e.diagram.model.addNodeData(data);
  var node = e.diagram.findPartForData(data);
  node.location = e.diagram.lastInput.documentPoint;
}

myDiagram.contextMenu =
  $(go.Adornment, "Vertical",
    $("ContextMenuButton",
      $(go.TextBlock, "Count Nodes"),
      { click: countNodes }),
    $("ContextMenuButton",
      $(go.TextBlock, "Add Node"),
      { click: addNode })
    // more ContextMenuButtons would go here
  );

myDiagram.model = new go.GraphLinksModel(
[
  { key: "Alpha", color: "lightblue" },
  { key: "Beta", color: "orange" }
]);
return myDiagram;      
如果在“节点”或“图”上单击鼠标右键(或在触摸设备上长按),您将看到显示带有已定义选项的GoJS上下文菜单。

该basic.html样品含有更复杂的上下文菜单的例子。有关更多信息,请参见GoJS上下文菜单上的“简介”页面。

链接互动

GoJS允许用户通过从端口中拖出或选择链接并拖动其手柄来绘制新链接并重新链接现有链接。要启用这些工具,需要设置一些属性:

myDiagram.nodeTemplate =
  $(go.Node, "Auto",
    $(go.Shape, "Rectangle",
      {
        stroke: null,
        portId: "",
        cursor: "pointer",
        fromLinkable: true, fromLinkableSelfNode: true, fromLinkableDuplicates: true,
        toLinkable: true, toLinkableSelfNode: true, toLinkableDuplicates: true
       },
      new go.Binding("fill", "color")),
    $(go.TextBlock,
      { margin: 6, font: "18px sans-serif" },
      new go.Binding("text", "key"))
  );

myDiagram.linkTemplate =
  $(go.Link,
    {
      // allow the user to relink existing links:
      relinkableFrom: true, relinkableTo: true,
      // draw the link path shorter than normal,
      // so that it does not interfere with the appearance of the arrowhead
      toShortLength: 2
    },
    $(go.Shape,
      { strokeWidth: 2 }),
    $(go.Shape,
      { toArrow: "Standard", stroke: null })
  );

myDiagram.model = new go.GraphLinksModel(
[
  { key: "Alpha", color: "lightblue" },
  { key: "Beta", color: "orange" },
  { key: "Gamma", color: "lightgreen" },
  { key: "Delta", color: "pink" }
],
[
  { from: 'Alpha', to: 'Beta' },
  { from: 'Alpha', to: 'Delta' },
]
);

在上面的示例中:

  • 该Shape有它的portId一套,使其端口,而不是整个节点。然后...linkable设置几个属性,允许每个节点链接到自身和其他节点。
  • 若要创建到另一个节点的新链接,请从端口(不位于TextBlock后面的Shape的边缘)拖动到任何节点,包括其自身。
  • 在链接模板中,relinkable...设置了属性,以便在选择链接时显示可以拖动的句柄,以便将链接与其他节点重新连接。


想要购买GoJS正版授权,或了解更多产品信息请点击


标签:

本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处、不得修改原文相关链接,如果存在内容上的异议请邮件反馈至chenjj@pclwef.cn

文章转载自:

为你推荐

  • 推荐视频
  • 推荐活动
  • 推荐产品
  • 推荐文章
  • 慧都慧问
扫码咨询


添加微信 立即咨询

电话咨询

客服热线
023-68661681

TOP