create-gojs-kit
Version:
A CLI for downloading GoJS samples, extensions, and docs
375 lines (337 loc) • 16 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="The Flow PanelLayout arranges panel elements in rows or columns." />
<meta itemprop="description" content="The Flow PanelLayout arranges panel elements in rows or columns." />
<meta property="og:description" content="The Flow PanelLayout arranges panel elements in rows or columns." />
<meta name="twitter:description" content="The Flow PanelLayout arranges panel elements in rows or columns." />
<link rel="preconnect" href="https://rsms.me/">
<link rel="stylesheet" href="../assets/css/style.css">
<!-- Copyright 1998-2025 by Northwoods Software Corporation. -->
<meta itemprop="name" content="Flow PanelLayout Wrapping Elements Into Rows or Columns" />
<meta property="og:title" content="Flow PanelLayout Wrapping Elements Into Rows or Columns" />
<meta name="twitter:title" content="Flow PanelLayout Wrapping Elements Into Rows or Columns" />
<meta property="og:image" content="https://gojs.net/latest/assets/images/screenshots/panellayoutflow.png" />
<meta itemprop="image" content="https://gojs.net/latest/assets/images/screenshots/panellayoutflow.png" />
<meta name="twitter:image" content="https://gojs.net/latest/assets/images/screenshots/panellayoutflow.png" />
<meta property="og:url" content="https://gojs.net/latest/samples/PanelLayoutFlow.html" />
<meta property="twitter:url" content="https://gojs.net/latest/samples/PanelLayoutFlow.html" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="og:type" content="website" />
<meta property="twitter:domain" content="gojs.net" />
<title>
Flow PanelLayout Wrapping Elements Into Rows or Columns | GoJS Diagramming Library
</title>
</head>
<body>
<!-- This top nav is not part of the sample code -->
<nav id="navTop" class=" w-full h-[var(--topnav-h)] z-30 bg-white border-b border-b-gray-200">
<div class="max-w-screen-xl mx-auto flex flex-wrap items-start justify-between px-4">
<a class="text-white bg-nwoods-primary font-bold !leading-[calc(var(--topnav-h)_-_1px)] my-0 px-2 text-4xl lg:text-5xl logo"
href="../">
GoJS
</a>
<div class="relative">
<button id="topnavButton" class="h-[calc(var(--topnav-h)_-_1px)] px-2 m-0 text-gray-900 bg-inherit shadow-none md:hidden hover:!bg-inherit hover:!text-nwoods-accent hover:!shadow-none" aria-label="Navigation">
<svg class="h-7 w-7 block" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24">
<path d="M3.75 6.75h16.5M3.75 12h16.5m-16.5 5.25h16.5" stroke-linecap="round" stroke-linejoin="round"/>
</svg>
</button>
<div id="topnavList" class="hidden md:block">
<div class="absolute right-0 z-30 flex flex-col items-end rounded border border-gray-200 p-4 pl-12 shadow bg-white text-gray-900 font-semibold
md:flex-row md:space-x-4 md:items-start md:border-0 md:p-0 md:shadow-none md:bg-inherit">
<a href="../learn/">Learn</a>
<a href="../samples/">Samples</a>
<a href="../intro/">Intro</a>
<a href="../api/">API</a>
<a href="../download.html">Download</a>
<a href="https://forum.nwoods.com/c/gojs/11" target="_blank" rel="noopener">Forum</a>
<a id="tc" href="https://nwoods.com/contact.html"
target="_blank" rel="noopener" onclick="getOutboundLink('https://nwoods.com/contact.html', 'contact');">Contact</a>
<a id="tb" href="https://nwoods.com/sales/index.html"
target="_blank" rel="noopener" onclick="getOutboundLink('https://nwoods.com/sales/index.html', 'buy');">Buy</a>
</div>
</div>
</div>
</div>
</nav>
<script>
window.addEventListener("DOMContentLoaded", function () {
// topnav
var topButton = document.getElementById("topnavButton");
var topnavList = document.getElementById("topnavList");
if (topButton && topnavList) {
topButton.addEventListener("click", function (e) {
topnavList
.classList
.toggle("hidden");
e.stopPropagation();
});
document.addEventListener("click", function (e) {
// if the clicked element isn't the list, close the list
if (!topnavList.classList.contains("hidden") && !e.target.closest("#topnavList")) {
topButton.click();
}
});
// set active <a> element
var url = window
.location
.href
.toLowerCase();
var aTags = topnavList.getElementsByTagName('a');
for (var i = 0; i < aTags.length; i++) {
var lowerhref = aTags[i]
.href
.toLowerCase();
if (lowerhref.endsWith('.html'))
lowerhref = lowerhref.slice(0, -5);
if (url.startsWith(lowerhref)) {
aTags[i]
.classList
.add('active');
break;
}
}
}
});
</script>
<div class="flex flex-col prose">
<div class="w-full max-w-screen-xl mx-auto">
<!-- * * * * * * * * * * * * * -->
<!-- Start of GoJS sample code -->
<script src="https://cdn.jsdelivr.net/npm/gojs@3.1.0"></script>
<div id="allSampleContent" class="p-4 w-full">
<script src="../extensions/Figures.js"></script>
<script src="../extensions/PanelLayoutFlow.js"></script>
<script id="code">
function init() {
myDiagram = new go.Diagram('myDiagramDiv', { 'undoManager.isEnabled': true });
myDiagram.nodeTemplate =
new go.Node('Vertical')
.add(
new go.TextBlock({ font: 'bold 10pt sans-serif' })
.bind('text'),
new go.Shape({
width: 40,
height: 40,
fill: 'white',
portId: '',
fromSpot: go.Spot.LeftRightSides,
toSpot: go.Spot.LeftRightSides
})
.bind('fill', 'color')
.bindTwoWay('figure'),
new go.Panel('Flow', {
maxSize: new go.Size(40, NaN),
background: 'transparent',
itemTemplate:
new go.Panel()
.add(
new go.TextBlock({
font: '9pt sans-serif',
margin: new go.Margin(1, 1, 0, 1)
})
.bind('text', '')
)
})
.bind('itemArray', 'values')
);
myDiagram.nodeTemplate.contextMenu =
new go.Adornment('Table', {
background: 'transparent',
defaultAlignment: go.Spot.Top,
padding: 10
})
.addRowDefinition(1, { height: 0 })
.add(
new go.Panel('Auto')
.add(
new go.Shape({ fill: 'transparent' }),
new go.Panel('Horizontal', {
row: 0,
stretch: go.Stretch.Vertical,
defaultStretch: go.Stretch.Horizontal
})
.add(
makeTabLabel('Rectangles', true),
makeTabLabel('Triangles'),
makeTabLabel('Other')
)
),
new go.Panel('Auto', { row: 2, stretch: go.Stretch.Fill })
.add(
new go.Shape({ fill: 'white' }),
new go.Panel('Auto')
.add(
new go.Shape({ fill: '#eee', margin: 4 }),
makeFlowPanel('Rectangles', ['Square', 'RoundedRectangle', 'Diamond', 'RoundedTopRectangle', 'RoundedBottomRectangle'], true),
makeFlowPanel('Triangles', ['TriangleUp', 'TriangleRight', 'TriangleDown', 'TriangleLeft', 'TriangleDownLeft', 'TriangleDownRight', 'TriangleUpLeft', 'TriangleUpRight']),
makeFlowPanel('Other', ['LineH', 'LineV', 'Curve1', 'Curve2', 'PlusLine', 'XLine', 'Heart', 'Lightning', 'Trapezoid', 'Octagon'])
)
)
);
//set the last thing for the context menu
myDiagram.nodeTemplate.contextMenu.lastPanelName = 'Rectangles';
function makeTabLabel(name, selected) {
let tabName = `${name}Tab`;
let textName = `${name}Text`;
return new go.Panel('Auto')
.attach({
_panelName: name //if we want the text content to be different than the name of the flow panel ever
})
.add(
new go.Shape('Rectangle', {
fill: selected ? '#ddd' : 'white',
stroke: selected ? 'red' : 'white',
strokeWidth: 1,
name: tabName,
mouseEnter: (e, obj) => {
let lastPanel = obj.part.findObject(obj.part.lastPanelName);
if (obj.part.lastPanelName != name) {
//highlight this and unhighlight the old one
obj.set({fill: '#ddd', stroke: 'red'});
obj.part.findObject(textName)?.set({stroke: 'red'});
if (lastPanel) {
let tab = obj.part.findObject(`${obj.part.lastPanelName}Tab`);
let text = obj.part.findObject(`${obj.part.lastPanelName}Text`);
tab?.set({fill: 'white', stroke: "white"});
text?.set({stroke: 'black'});
//make it invisible (the actual flow panel)
lastPanel.set({visible: false});
}
}
//make the new panel visible
obj.part.findObject(name)?.set({visible: true});
obj.part.lastPanelName = name;
}
}),
new go.TextBlock(name, {
margin: 6,
stroke: selected ? 'red' : 'black',
name: textName
})
);
}
function makeFlowPanel(name, figures, selected) {
return new go.Panel('Auto', { padding: 10 })
.add(
new go.Shape({ fill: 'transparent', strokeWidth: 0 }),
new go.Panel(new PanelLayoutFlow({
spacing: new go.Size(5, 5),
direction: 0
}), {
name: name,
maxSize: new go.Size(150, 150),
visible: !!selected
})
.add(
...figures.map(makeShape)
)
);
}
function makeShape(fig) {
return new go.Shape(fig, {
width: 20,
height: 20,
fill: 'white',
margin: 5,
background: 'transparent', // to catch a click anywhere in bounds
strokeWidth: 2,
stroke: 'black',
click: (e, shape) => {
var ad = shape.part;
e.diagram.commit(diag => {
diag.model.set(ad.data, 'figure', fig);
ad.adornedPart.invalidateConnectedLinks();
}, 'modified figure');
},
mouseEnter: (e, obj) => {
obj.fill = 'gray';
},
mouseLeave: (e, obj) => {
obj.fill = 'white';
}
})
.trigger('fill', { duration: 125 });
}
myDiagram.model = new go.GraphLinksModel(
[
{ key: 1, text: 'Alpha', color: 'lightblue', values: ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H'] },
{ key: 2, text: 'Beta', color: 'orange', figure: 'Diamond', values: ['I', 'J'] },
{ key: 3, text: 'Gamma', color: 'lightgreen', figure: 'Circle', values: ['123', '456', '7890'] },
{ key: 4, text: 'Delta', color: 'pink', figure: 'Triangle' }
],
[
{ from: 1, to: 2 },
{ from: 1, to: 3 },
{ from: 3, to: 4 },
{ from: 4, to: 1 }
]
);
}
window.addEventListener('DOMContentLoaded', init);
</script>
<div id="sample">
<div id="myDiagramDiv" style="border: solid 1px black; width: 100%; height: 600px"></div>
<p>Each node has a "Flow" PanelLayout below the shape listing a bunch of text values in rows.</p>
<p>
The context menu shown for each node has three "tabs", each showing some number of shape figures, one of which the user can click to replace the node's
shape's figure. These tab panels use a "Flow" PanelLayout to arrange the shapes in rows, by setting <a>PanelLayoutFlow.direction</a> to 0. Note how for
a custom <a>PanelLayout</a> one cannot use its name directly, but must construct and initialize an instance of the PanelLayout.
</p>
<p>This extension is defined in its own file, as <a href="../extensions/PanelLayoutFlow.js">PanelLayoutFlow.js</a>.</p>
</div>
</div>
<!-- * * * * * * * * * * * * * -->
<!-- End of GoJS sample code -->
</div>
<div id="allTagDescriptions" class="p-4 w-full max-w-screen-xl mx-auto">
<hr/>
<h3 class="text-xl">GoJS Features in this sample</h3>
<!-- blacklist tags that do not correspond to a specific GoJS feature -->
<h4>Custom Layouts</h4>
<p>
GoJS allows for the creation of custom layouts to meet specific needs.
</p>
<p>
There are also many layouts that are extensions -- not predefined in the <code>go.js</code> or <code>go-debug.js</code> library,
but available as source code in one of the three extension directories, with some documentation and corresponding samples.
More information can be found in the <a href="../intro/layouts.html#CustomLayouts">GoJS Intro</a>.
</p>
<p>
<a href="../samples/index.html#customlayout">Related samples</a>
</p>
<hr>
<!-- blacklist tags that do not correspond to a specific GoJS feature -->
<h4>GoJS Extensions</h4>
<p>
<b>GoJS</b> can be extended in a variety of ways.
The most common way to change the standard behavior is to set properties on the <a href="../api/symbols/GraphObject.html" target="api">GraphObject</a>, <a href="../api/symbols/Diagram.html" target="api">Diagram</a>, <a href="../api/symbols/CommandHandler.html" target="api">CommandHandler</a>, <a href="../api/symbols/Tool.html" target="api">Tool</a>, or <a href="../api/symbols/Layout.html" target="api">Layout</a>.
But when the desired property does not exist, you might need to override methods of CommandHandler, Tool, Layout, Link, or Node.
Methods that you can override are documented in the API reference.
Various features of GoJS can be overriden, either by replacing a method on an instance (a feature of JavaScript) or by defining a subclass.
You should not modify the prototypes of any of the <b>GoJS</b> classes.
</p>
<p>
In addition to our samples, <b>GoJS</b> provides an <strong><a href="../samples/#extensions">extensions gallery</a></strong>,
showcasing the creation of custom tools and layouts.
Those classes and samples are written in TypeScript, available at <code>../extensionsJSM/</code>,
as ECMAScript/JavaScript modules -- these use the <code>../release/go-module.js</code> library.
We recommend that you copy the files that you need into your project, so that you can adjust how they refer to the GoJS library
that you choose and so that you can include them into your own building and packaging procedures.
</p>
<p>
More information can be found in the <a href="../intro/extensions.html">GoJS Intro</a>.
</p>
<p>
<a href="../samples/index.html#extensions">Related samples</a>
</p>
<hr>
</div>
</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>