gojs
Version:
Interactive diagrams, charts, and graphs, such as trees, flowcharts, orgcharts, UML, BPMN, or business diagrams
263 lines (245 loc) • 11.4 kB
HTML
<html lang="en">
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no, viewport-fit=cover"/>
<meta name="description" content="A diagram that shows a sheet of paper; nodes cannot be dragged or resized beyond the edge of the sheet."/>
<link rel="stylesheet" href="../assets/css/style.css"/>
<!-- Copyright 1998-2023 by Northwoods Software Corporation. -->
<title>A Single Page Diagram</title>
</head>
<body>
<!-- This top nav is not part of the sample code -->
<nav id="navTop" class="w-full z-30 top-0 text-white bg-nwoods-primary">
<div class="w-full container max-w-screen-lg mx-auto flex flex-wrap sm:flex-nowrap items-center justify-between mt-0 py-2">
<div class="md:pl-4">
<a class="text-white hover:text-white no-underline hover:no-underline
font-bold text-2xl lg:text-4xl rounded-lg hover:bg-nwoods-secondary " href="../">
<h1 class="my-0 p-1 ">GoJS</h1>
</a>
</div>
<button id="topnavButton" class="rounded-lg sm:hidden focus:outline-none focus:ring" aria-label="Navigation">
<svg fill="currentColor" viewBox="0 0 20 20" class="w-6 h-6">
<path id="topnavOpen" fill-rule="evenodd" d="M3 5a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM3 10a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM9 15a1 1 0 011-1h6a1 1 0 110 2h-6a1 1 0 01-1-1z" clip-rule="evenodd"></path>
<path id="topnavClosed" class="hidden" fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd"></path>
</svg>
</button>
<div id="topnavList" class="hidden sm:block items-center w-auto mt-0 text-white p-0 z-20">
<ul class="list-reset list-none font-semibold flex justify-end flex-wrap sm:flex-nowrap items-center px-0 pb-0">
<li class="p-1 sm:p-0"><a class="topnav-link" href="../learn/">Learn</a></li>
<li class="p-1 sm:p-0"><a class="topnav-link" href="../samples/">Samples</a></li>
<li class="p-1 sm:p-0"><a class="topnav-link" href="../intro/">Intro</a></li>
<li class="p-1 sm:p-0"><a class="topnav-link" href="../api/">API</a></li>
<li class="p-1 sm:p-0"><a class="topnav-link" href="https://www.nwoods.com/products/register.html">Register</a></li>
<li class="p-1 sm:p-0"><a class="topnav-link" href="../download.html">Download</a></li>
<li class="p-1 sm:p-0"><a class="topnav-link" href="https://forum.nwoods.com/c/gojs/11">Forum</a></li>
<li class="p-1 sm:p-0"><a class="topnav-link" href="https://www.nwoods.com/contact.html"
target="_blank" rel="noopener" onclick="getOutboundLink('https://www.nwoods.com/contact.html', 'contact');">Contact</a></li>
<li class="p-1 sm:p-0"><a class="topnav-link" href="https://www.nwoods.com/sales/index.html"
target="_blank" rel="noopener" onclick="getOutboundLink('https://www.nwoods.com/sales/index.html', 'buy');">Buy</a></li>
</ul>
</div>
</div>
<hr class="border-b border-gray-600 opacity-50 my-0 py-0" />
</nav>
<div class="md:flex flex-col md:flex-row md:min-h-screen w-full max-w-screen-xl mx-auto">
<div id="navSide" class="flex flex-col w-full md:w-48 text-gray-700 bg-white flex-shrink-0"></div>
<!-- * * * * * * * * * * * * * -->
<!-- Start of GoJS sample code -->
<script src="../release/go.js"></script>
<div id="allSampleContent" class="p-4 w-full">
<div id="sample">
<div id="myDiagramDiv" style="border: solid 1px black; width:100%; height:650px"></div>
<p>
This pretends to show a sheet of paper with the diagram on it.
</p>
<p>
Both the <a>DraggingTool</a> and the <a>ResizingTool</a> are constrained to keep the nodes within
the area of the sheet of paper, minus the margins.
The user can zoom and scroll/pan normally.
There are several variables, such as <code>pageSize</code>, that govern how the sheet of paper is set up.
</p>
<p>
The Legend is implemented with a template that is assumed to only be used for a single Part.
It is located at the bottom right corner of the usable area.
Its text can be edited, and the legend adapts in size automatically.
</p>
</div>
<script id="code">
// Since 2.2 you can also author concise templates with method chaining instead of GraphObject.make
// For details, see https://gojs.net/latest/intro/buildingObjects.html
const $ = go.GraphObject.make;
const pageSize = new go.Size(792, 612); // landscape, or new go.Size(612, 792) for portrait
const pageMargin = new go.Margin(8); // margin around the sheet
const usableMargin = new go.Margin(16); // padding inside sheet border
const pageBounds = new go.Rect(-usableMargin.left, -usableMargin.top, pageSize.width, pageSize.height);
const usableArea = pageBounds.copy().subtractMargin(usableMargin);
myDiagram =
new go.Diagram("myDiagramDiv",
{
fixedBounds: pageBounds.copy().addMargin(pageMargin),
initialAutoScale: go.Diagram.Uniform,
"animationManager.isInitial": false,
"undoManager.isEnabled": true,
"draggingTool.isGridSnapEnabled": true,
"draggingTool.gridSnapCellSize": new go.Size(10, 10),
"resizingTool.isGridSnapEnabled": true,
"resizingTool.cellSize": new go.Size(10, 10),
// override ResizingTool methods to limit where the resizing may go
"resizingTool.doMouseMove": function() { // method override must be function, not =>
var e = this.diagram.lastInput;
e.documentPoint = limitPoint(e.documentPoint);
e.viewPoint = this.diagram.transformDocToView(e.documentPoint);
go.ResizingTool.prototype.doMouseMove.call(this);
},
"resizingTool.doMouseUp": function() { // method override must be function, not =>
var e = this.diagram.lastInput;
e.documentPoint = limitPoint(e.documentPoint);
e.viewPoint = this.diagram.transformDocToView(e.documentPoint);
go.ResizingTool.prototype.doMouseUp.call(this);
},
// if text has changed, maybe the node bounds has changed too
"TextEdited": e => {
var node = e.subject.part;
node.ensureBounds(); // has been resized, compute its new bounds
var pt = limitPoint(node.location);
node.location = stayInFixedArea(node, pt, pt);
}
});
// The background Part showing the sheet of paper;
// it includes the fixed bounds of the diagram contents
myDiagram.add(
$(go.Part, "Grid",
{
layerName: "Grid",
position: pageBounds.position,
desiredSize: pageSize,
isShadowed: true,
background: "floralwhite"
},
$(go.Shape, "LineH", { stroke: "lightgray", strokeWidth: 0.5 }),
$(go.Shape, "LineV", { stroke: "lightgray", strokeWidth: 0.5 })
));
// This function is the Node.dragComputation, to limit the movement of the parts.
function stayInFixedArea(part, pt, gridpt) {
const diagram = part.diagram;
if (diagram === null) return pt;
// compute the document area without padding
const v = usableArea;
// get the bounds of the part being dragged
const bnd = part.actualBounds;
const loc = part.location;
// now limit the location appropriately
const l = v.x + (loc.x - bnd.x);
const r = v.right - (bnd.right - loc.x);
const t = v.y + (loc.y - bnd.y);
const b = v.bottom - (bnd.bottom - loc.y);
if (l <= gridpt.x && gridpt.x <= r && t <= gridpt.y && gridpt.y <= b) return gridpt;
const p = gridpt.copy();
if (diagram.toolManager.draggingTool.isGridSnapEnabled) {
// find a location that is inside V but also keeps the part's bounds within V
const cw = diagram.grid.gridCellSize.width;
if (cw > 0) {
while (p.x > r) p.x -= cw;
while (p.x < l) p.x += cw;
}
const ch = diagram.grid.gridCellSize.height;
if (ch > 0) {
while (p.y > b) p.y -= ch;
while (p.y < t) p.y += ch;
}
return p;
} else {
p.x = Math.max(l, Math.min(p.x, r));
p.y = Math.max(t, Math.min(p.y, b));
return p;
}
}
function limitPoint(p) {
return new go.Point(Math.max(usableArea.left, Math.min(p.x, usableArea.right)),
Math.max(usableArea.top, Math.min(p.y, usableArea.bottom)));
}
myDiagram.nodeTemplate =
$(go.Node, "Auto",
{
resizable: true, // but limited by overrides of ResizingTool methods, above
dragComputation: stayInFixedArea // this limits the DraggingTool
},
$(go.Shape,
{ fill: "white", portId: "", fromLinkable: true, toLinkable: true, cursor: "pointer" },
new go.Binding("fill", "color")),
$(go.TextBlock,
{ margin: 8, editable: true },
new go.Binding("text").makeTwoWay())
);
myDiagram.linkTemplate =
$(go.Link,
{ relinkableFrom: true, relinkableTo: true },
$(go.Shape),
$(go.Shape, { toArrow: "OpenTriangle" })
);
// The Legend Part, presumably a singleton
function makeField(name, propname, row, col, span) {
if (!span) span = 1;
return [
$(go.TextBlock, name,
{
row: row, column: col, columnSpan: span,
alignment: go.Spot.TopLeft, margin: new go.Margin(2, 0, 16, 2),
stroke: "gray", font: "9pt sans-serif", isMultiline: false
}),
$(go.TextBlock,
{
row: row, column: col, columnSpan: span,
alignment: go.Spot.Center, margin: new go.Margin(16, 4, 1, 4),
textAlign: "center", editable: true
},
new go.Binding("text", propname).makeTwoWay())
];
}
function makeSeparator(row, col) {
return $(go.Shape, "LineV",
{ row: row, column: col, width: 0, stretch: go.GraphObject.Vertical, stroke: "gray" });
}
myDiagram.nodeTemplateMap.add("Legend",
$(go.Part, "Auto",
{
layerName: "Background",
locationSpot: go.Spot.BottomRight,
location: new go.Point().setRectSpot(usableArea, go.Spot.BottomRight),
deletable: false, movable: false, copyable: false,
selectionAdorned: false
},
$(go.Shape, { fill: "white", stroke: "gray" }),
$(go.Panel, "Table",
{ defaultRowSeparatorStroke: "gray" },
makeField("Title:", "title", 0, 0, 5),
makeField("Project:", "name", 1, 0, 3),
makeSeparator(1, 3),
makeField("Number:", "number", 1, 4),
)
));
myDiagram.model = new go.GraphLinksModel(
[
{ category: "Legend", title: "Sample Fixed Diagram", name: "Your Company", number: "123-45a" },
{ key: 1, text: "Alpha", color: "lightblue" },
{ key: 2, text: "Beta", color: "orange" },
{ key: 3, text: "Gamma", color: "lightgreen" },
{ key: 4, text: "Delta", color: "pink" }
],
[
{ from: 1, to: 2 },
{ from: 1, to: 3 },
{ from: 2, to: 2 },
{ from: 3, to: 4 },
{ from: 4, to: 1 }
]);
</script>
</div>
<!-- * * * * * * * * * * * * * -->
<!-- End of GoJS sample code -->
</div>
</body>
<!-- This script is part of the gojs.net website, and is not needed to run the sample -->
<script src="../assets/js/goSamples.js"></script>
</html>