GoJS是一款功能強大，快速且輕量級的流程圖控件，可幫助你在JavaScript 和HTML5 Canvas程序中創(chuàng)建流程圖，且極大地簡化您的JavaScript / Canvas 程序。

GoJS現(xiàn)已更新至最新版本2.0.16發(fā)布，修復(fù)了一些bug，增強用戶體驗，趕快下載試試吧~

點擊下載GoJS最新試用版

更改數(shù)據(jù)值

以上所有示例均取決于 創(chuàng)建部件并將部件Panel.data屬性設(shè)置為引用相應(yīng)的節(jié)點或鏈接數(shù)據(jù)時要評估的數(shù)據(jù)綁定。這些動作發(fā)生時自動圖表用于在設(shè)定模型的數(shù)據(jù)創(chuàng)建圖份Diagram.model。

但是，GoJS不知道何時修改了任意JavaScript對象的data屬性。如果要更改模型中的某些數(shù)據(jù)對象并自動更新圖表，則應(yīng)執(zhí)行的操作取決于所更改屬性的性質(zhì)。

對于大多數(shù)數(shù)據(jù)屬性，模型不會對其進(jìn)行特殊處理，但它們是數(shù)據(jù)綁定的，您只需調(diào)用Model.setDataProperty即可。在此示例中，我們修改節(jié)點數(shù)據(jù)對象上的“ highlight”值。此修改大約每秒發(fā)生兩次。

 diagram.nodeTemplate =
    $(go.Node, "Auto",
      { locationSpot: go.Spot.Center },
      $(go.Shape, "RoundedRectangle",
        { // default values if the data.highlight is undefined:
          fill: "yellow", stroke: "orange", strokeWidth: 2 },
        new go.Binding("fill", "highlight", function(v) { return v ? "pink" : "lightblue"; }),
        new go.Binding("stroke", "highlight", function(v) { return v ? "red" : "blue"; }),
        new go.Binding("strokeWidth", "highlight", function(v) { return v ? 3 : 1; })),
      $(go.TextBlock,
        { margin: 5 },
        new go.Binding("text", "key"))
    );
 
  diagram.model.nodeDataArray = [
    { key: "Alpha", highlight: false }  // just one node, and no links
  ];
 
  function flash() {
    // all model changes should happen in a transaction
    diagram.model.commit(function(m) {
      var data = m.nodeDataArray[0];  // get the first node data
      m.set(data, "highlight", !data.highlight);
    }, "flash");
  }
  function loop() {
    setTimeout(function() { flash(); loop(); }, 500);
  }
  loop();

改變圖結(jié)構(gòu)

對于模型知道的數(shù)據(jù)屬性，例如鏈接數(shù)據(jù)的“到”或“從”，必須調(diào)用適當(dāng)?shù)哪Ｐ头椒ú拍苄薷臄?shù)據(jù)屬性。直接修改數(shù)據(jù)屬性而不調(diào)用適當(dāng)?shù)哪Ｐ头椒赡軙?dǎo)致不一致或不確定的行為。

對于節(jié)點數(shù)據(jù)，模型方法是 Model.setCategoryForNodeData， Model.setKeyForNodeData， GraphLinksModel.setGroupKeyForNodeData， TreeModel.setParentKeyForNodeData和 TreeModel.setParentLinkCategoryForNodeData。對于鏈接數(shù)據(jù)，模型方法為GraphLinksModel.setCategoryForLinkData， GraphLinksModel.setFromKeyForLinkData， GraphLinksModel.setFromPortIdForLinkData， GraphLinksModel.setToKeyForLinkData， GraphLinksModel.setToPortIdForLinkData和GraphLinksModel.setLabelKeysForLinkData。

本示例更改鏈接數(shù)據(jù)的“ to”屬性，從而使鏈接連接到其他節(jié)點。

  diagram.nodeTemplate =
    $(go.Node, "Auto",
      { locationSpot: go.Spot.Center },
      $(go.Shape, "RoundedRectangle",
        { fill: "yellow", stroke: "orange", strokeWidth: 2 }),
      $(go.TextBlock,
        { margin: 5 },
        new go.Binding("text", "key"))
    );
 
  var nodeDataArray = [
    { key: "Alpha" },
    { key: "Beta" },
    { key: "Gamma" }
  ];
  var linkDataArray = [
    { from: "Alpha", to: "Beta" }
  ];
  diagram.model = new go.GraphLinksModel(nodeDataArray, linkDataArray);
 
  function switchTo() {
    // all model changes should happen in a transaction
    diagram.model.commit(function(m) {
      var data = m.linkDataArray[0];  // get the first link data
      if (m.getToKeyForLinkData(data) === "Beta")
        m.setToKeyForLinkData(data, "Gamma");
      else
        m.setToKeyForLinkData(data, "Beta");
    }, "reconnect link");
  }
  function loop() {
    setTimeout(function() { switchTo(); loop(); }, 1000);
  }
  loop();

綁定到GraphObject源

綁定源對象不必是圖模型中保存的普通JavaScript數(shù)據(jù)對象。相反，源對象可以是同一Part中的一個命名GraphObject。source屬性必須是該類的可設(shè)置屬性。當(dāng)屬性設(shè)置為新值時，將評估綁定。

這種綁定的一種常見用法是當(dāng)Part.isSelected時更改Part的外觀。調(diào)用Binding.ofObject以使Binding使用其GraphObject.name是給定名稱的對象。使用空字符串“”或不使用參數(shù)來引用整個Part本身。這是一種方便，因此您無需命名整個零件。“ ofObject”實際上表示“名為...的GraphObject的”，如存在字符串參數(shù)時由Panel.findObject找到的。

在下面的示例中，Shape.fill綁定到Part.isSelected屬性。當(dāng)選擇或取消選擇節(jié)點時，Part.isSelected屬性將更改值，因此將對綁定進(jìn)行評估。轉(zhuǎn)換函數(shù)獲取布爾值，并返回所需的筆刷顏色以用作形狀的填充。此示例還關(guān)閉了選擇裝飾，因此，唯一的可視方法（即形狀的填充顏色）是表明已選擇節(jié)點的方法。

  diagram.nodeTemplate =
    $(go.Node, "Auto",
      { selectionAdorned: false },  // no blue selection handle!
      $(go.Shape, "RoundedRectangle",
        // bind Shape.fill to Node.isSelected converted to a color
        new go.Binding("fill", "isSelected", function(sel) {
              return sel ? "dodgerblue" : "lightgray";
            }).ofObject()),  // no name means bind to the whole Part
      $(go.TextBlock,
        { margin: 5 },
        new go.Binding("text", "descr"))
    );
 
  diagram.model.nodeDataArray = [
    { descr: "Select me!" },
    { descr: "I turn blue when selected." }
  ];

注意：請勿聲明綁定依賴項的循環(huán)-這將導(dǎo)致未定義的行為。 GraphObject綁定源還要求將Part綁定到數(shù)據(jù)（即Part.data必須為非null）。GraphObject上的屬性必須是可設(shè)置的，因此它不適用于只讀屬性，例如那些返回計算值（例如Part.isTopLevel）或迭代器（例如Node.linksConnected）的屬性。

綁定到共享的Model.modelData源

除了Panel.data或面板中的某些GraphObject之外，綁定源對象可能是第三種來源。也可以是JavaScript對象，它是共享的Model.modelData對象。這允許將節(jié)點或鏈接元素屬性綁定到模型中將存在的共享屬性，即使模型中不存在節(jié)點或鏈接也可以對其進(jìn)行修改。

在下面的示例中，Shape.fill綁定到Model.modelData對象上的“ color”屬性。單擊按鈕時，該changeColor函數(shù)modelData通過調(diào)用Model.setDataProperty修改對象。

diagram.nodeTemplate =
  $(go.Node, "Auto",
    $(go.Shape, "RoundedRectangle",
      { fill: "white" },  // the default value if there is no modelData.color property
      new go.Binding("fill", "color").ofModel()),  // meaning a property of Model.modelData
    $(go.TextBlock,
      { margin: 5 },
      new go.Binding("text"))
  );
// start all nodes yellow
diagram.model.modelData.color = "yellow";
 
diagram.model.nodeDataArray = [
  { text: "Alpha" },
  { text: "Beta" }
];
 
diagram.undoManager.isEnabled = true;
 
changeColor = function() {  // define a function named "changeColor" callable by button.onclick
  diagram.model.commit(function(m) {
    // alternate between lightblue and lightgreen colors
    var oldcolor = m.modelData.color;
    var newcolor = (oldcolor === "lightblue" ? "lightgreen" : "lightblue");
    m.set(m.modelData, "color", newcolor);
  }, "changed shared color");
}

雙向數(shù)據(jù)綁定

上面的所有綁定僅將值從源數(shù)據(jù)傳輸?shù)侥繕?biāo)屬性。但是有時您希望能夠?qū)raphObject的值傳輸回模型數(shù)據(jù)，以使模型數(shù)據(jù)與圖保持最新。這可以通過使用TwoWay Binding來實現(xiàn)，該方法不僅可以將值從源傳遞到目標(biāo)，還可以將目標(biāo)對象中的值傳遞回源數(shù)據(jù)。

 diagram.nodeTemplate =
    $(go.Node, "Auto",
      { locationSpot: go.Spot.Center },
      new go.Binding("location", "loc").makeTwoWay(),  // TwoWay Binding
      $(go.Shape, "RoundedRectangle",
        { fill: "lightblue", stroke: "blue", strokeWidth: 2 }),
      $(go.TextBlock,
        { margin: 5 },
        new go.Binding("text", "key"))
    );
 
  var nodeDataArray = [
    { key: "Alpha", loc: new go.Point(0, 0) }
  ];
  diagram.model = new go.GraphLinksModel(nodeDataArray);
 
  shiftNode = (function() {  // define a function named "shiftNode" callable by button.onclick
    // all model changes should happen in a transaction
    diagram.commit(function(d) {
      var data = d.model.nodeDataArray[0];  // get the first node data
      var node = d.findNodeForData(data);   // find the corresponding Node
      var p = node.location.copy();  // make a copy of the location, a Point
      p.x += 10;
      if (p.x > 200) p.x = 0;
      // changing the Node.location also changes the data.loc property due to TwoWay binding
      node.location = p;
      // show the updated location held by the "loc" property of the node data
      document.getElementById("bindTwoWayData").textContent = data.loc.toString();
    }, "shift node");
  });
  shiftNode();  // initialize everything

單擊按鈕以移動節(jié)點。效果基本上就是用戶拖動節(jié)點時發(fā)生的情況。在此示例中，在Node.location上的雙向綁定將更新作為Node的Part.data的節(jié)點數(shù)據(jù)的“ loc”屬性。

正如從源到目標(biāo)時可以使用轉(zhuǎn)換函數(shù)一樣，可以為Binding.makeTwoWay提供從目標(biāo)到源去轉(zhuǎn)換函數(shù)。例如，在模型數(shù)據(jù)中以字符串而不是Point表示位置：

// storage representation of Points/Sizes/Rects/Margins/Spots is as strings, not objects:new go.Binding("location", "loc", go.Point.parse).makeTwoWay(go.Point.stringify)

但是，您不能在作為“鍵”屬性的節(jié)點數(shù)據(jù)屬性上具有TwoWay綁定。（默認(rèn)為名稱“鍵”，但實際上是Model.nodeKeyProperty的值。）該屬性值在模型內(nèi)的所有節(jié)點數(shù)據(jù)中必須始終是唯一的，并且模型可以識別。雙向綁定可能會更改該值，從而導(dǎo)致許多問題。同樣，Node.key屬性是只讀的，以防止意外更改鍵值。

雙向綁定的原因

在可設(shè)置的屬性上 使用雙向綁定的基本原因是要確保對該屬性的任何更改都將被復(fù)制到相應(yīng)的模型數(shù)據(jù)中。通過確保模型是最新的，您只需保存模型即可輕松地“保存圖”，而“加載圖”只需將模型加載到內(nèi)存中并設(shè)置Diagram.model即可。如果您僅在模型數(shù)據(jù)中保留JSON可序列化的數(shù)據(jù)，則可以使用Model.toJson和Model.fromJson方法在模型和文本表示之間進(jìn)行轉(zhuǎn)換。

大多數(shù)綁定不需要是TwoWay。 出于性能原因，除非您確實需要將更改傳播回數(shù)據(jù)，否則不應(yīng)將Binding設(shè)為TwoWay。大多數(shù)可設(shè)置的屬性僅在初始化時設(shè)置，然后永不更改。

可設(shè)置屬性僅在某些代碼對其進(jìn)行設(shè)置時才更改值。該代碼可能在您作為應(yīng)用程序一部分編寫的代碼中。或者它可能在命令或工具中。這是一個可能存在雙向綁定的屬性列表，因為預(yù)定義的命令或工具之一對其進(jìn)行了修改：

• Part.location，通過DraggingTool如果已啟用

• Link.points，通過LinkReshapingTool（如果已啟用）

• GraphObject.desiredSize，由ResizingTool啟用（如果已啟用）

• GraphObject.angle，由RotatingTool啟用（如果已啟用）

• TextBlock.text，如果已啟用，則由TextEditingTool進(jìn)行

• Part.isSelected，通過許多工具和命令

• Node.isTreeExpanded和Node.wasTreeExpanded，通過CommandHandler.collapseTree和CommandHandler.expandTree，由“TreeExpanderButton”之稱

• Group.isSubGraphExpanded和Group.wasSubGraphExpanded，通過CommandHandler.collapseSubGraph和CommandHandler.expandSubGraph，由“SubGraphExpanderButton”之稱

如果修改屬性的工具無法運行，或者修改屬性的命令無法調(diào)用，則無需在屬性上使用TwoWay綁定。除非編寫代碼來修改它們，否則您可能不需要任何其他屬性的TwoWay綁定。即使這樣，有時還是最好通過直接調(diào)用Model.setDataProperty來編寫代碼來修改模型數(shù)據(jù)，這取決于OneWay綁定來更新GraphObject屬性。

如果源是GraphObject而不是模型數(shù)據(jù)，也可以使用TwoWay綁定。當(dāng)您不希望將狀態(tài)存儲在模型中，但又想在同一零件中同步GraphObjects的屬性時，則不需要這樣做。 謹(jǐn)慎使用TwoWay綁定。

=====================================================

想要購買GoJS正版授權(quán)的朋友可以。

更多精彩內(nèi)容，歡迎關(guān)注下方的微信公眾號，及時獲取產(chǎn)品最新資訊▼▼▼