create-gojs-kit
Version:
A CLI for downloading GoJS samples, extensions, and docs
302 lines (267 loc) • 13.3 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="An instrument gauge implemented in GoJS using a Graduated Panel." />
<meta itemprop="description" content="An instrument gauge implemented in GoJS using a Graduated Panel." />
<meta property="og:description" content="An instrument gauge implemented in GoJS using a Graduated Panel." />
<meta name="twitter:description" content="An instrument gauge implemented in GoJS using a Graduated Panel." />
<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="Instrument Gauge Using Graduated Panel" />
<meta property="og:title" content="Instrument Gauge Using Graduated Panel" />
<meta name="twitter:title" content="Instrument Gauge Using Graduated Panel" />
<meta property="og:image" content="https://gojs.net/latest/assets/images/screenshots/instrumentgauge.png" />
<meta itemprop="image" content="https://gojs.net/latest/assets/images/screenshots/instrumentgauge.png" />
<meta name="twitter:image" content="https://gojs.net/latest/assets/images/screenshots/instrumentgauge.png" />
<meta property="og:url" content="https://gojs.net/latest/samples/instrumentGauge.html" />
<meta property="twitter:url" content="https://gojs.net/latest/samples/instrumentGauge.html" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="og:type" content="website" />
<meta property="twitter:domain" content="gojs.net" />
<title>
Instrument Gauge Using Graduated Panel | 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 id="code">
function init() {
myDiagram = new go.Diagram('myDiagramDiv');
myDiagram.nodeTemplate =
new go.Node('Auto')
.add(
new go.Shape('Circle', {
stroke: 'orange',
strokeWidth: 5,
spot1: go.Spot.TopLeft,
spot2: go.Spot.BottomRight
})
.bind('stroke', 'color'),
new go.Panel('Spot')
.add(
new go.Panel('Graduated', {
name: 'SCALE',
margin: 14,
graduatedTickUnit: 2.5, // tick marks at each multiple of 2.5
graduatedMax: 100, // this is actually the default value
stretch: go.Stretch.None // needed to avoid unnecessary re-measuring!!!
})
.bind('graduatedMax', 'max') // controls the range of the gauge
.add(
// the main path of the graduated panel, an arc starting at 135 degrees and sweeping for 270 degrees
new go.Shape({
name: 'SHAPE',
geometryString: 'M-70.7107 70.7107 B135 270 0 0 100 100 M0 100',
stroke: 'white',
strokeWidth: 4
}),
// three differently sized tick marks
new go.Shape({
geometryString: 'M0 0 V10',
stroke: 'white',
strokeWidth: 1.5
}),
new go.Shape({
geometryString: 'M0 0 V12',
stroke: 'white',
strokeWidth: 2.5,
interval: 2
}),
new go.Shape({
geometryString: 'M0 0 V15',
stroke: 'white',
strokeWidth: 3.5,
interval: 4
}),
new go.TextBlock({
// each tick label
interval: 4,
alignmentFocus: go.Spot.Center,
font: 'bold italic 14pt sans-serif',
stroke: 'white',
segmentOffset: new go.Point(0, 30)
})
),
new go.TextBlock({
alignment: new go.Spot(0.5, 0.9),
stroke: 'orange',
font: 'bold italic 14pt sans-serif'
})
.bind('text')
.bind('stroke', 'color'),
new go.Shape({
fill: 'red',
strokeWidth: 0,
geometryString: 'F1 M-6 0 L0 -6 100 0 0 6z x M-100 0'
})
.bind('angle', 'value', convertValueToAngle),
new go.Shape('Circle', { width: 2, height: 2, fill: '#444' })
)
);
// this determines the angle of the needle, based on the data.value argument
function convertValueToAngle(v, shape) {
var scale = shape.part.findObject('SCALE');
var p = scale.graduatedPointForValue(v);
var shape = shape.part.findObject('SHAPE');
var c = shape.actualBounds.center;
return c.directionPoint(p);
}
myDiagram.model = new go.GraphLinksModel(
[
{ key: 1, text: 'Alpha', value: 35 },
{ key: 2, text: 'Beta', color: 'green', max: 140, value: 70 }
],
[{ from: 1, to: 2 }]
);
loop();
}
// change each gauge's value several times a second
function loop() {
setTimeout(() => {
myDiagram.startTransaction();
myDiagram.nodes.each(node => {
var scale = node.findObject('SCALE');
if (scale === null || scale.type !== go.Panel.Graduated) return;
// keep the new value within the range of the graduated panel
var min = scale.graduatedMin;
var max = scale.graduatedMax;
var v = node.data.value;
if (v === undefined) v = Math.floor((max - min) / 2); // default to middle value
if (v < min) v++;
else if (v > max) v--;
else v += Math.random() < 0.5 ? -0.5 : 0.5; // random walk
myDiagram.model.setDataProperty(node.data, 'value', v);
});
myDiagram.commitTransaction('modified Graduated Panel');
loop();
}, 1000 / 6);
}
window.addEventListener('DOMContentLoaded', init);
</script>
<div id="sample">
<div id="myDiagramDiv" style="border: solid 1px black; width: 100%; height: 350px"></div>
<p>
This makes use of a <a href="../intro/graduatedPanels.html">"Graduated"</a> <a>Panel</a>, which holds the main path of the scale, a Shape whose
<a>Shape.geometry</a> is a circular arc. In addition that Graduated Panel holds three different Shapes acting as templates for tick marks and a TextBlock
acting as a template for tick labels.
</p>
<p>
In a Spot Panel with the Graduated Panel scale are an italic TextBlock showing the node identifier and a red elongated diamond "needle" Shape. The needle's
angle is determined by <code>convertValueToAngle</code>, which finds the point on the Graduated Panel's main path element corresponding to
<code>data.value</code> and computes the angle from the center to that point. The data value is updated several times per second. A circle Shape surrounds
the Spot Panel.
</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 -->
<!-- blacklist tags that do not correspond to a specific GoJS feature -->
<h4>Geometry Path Strings</h4>
<p>
The <b>GoJS</b> <a href="../api/symbols/Geometry.html" target="api">Geometry</a> class controls the "shape" of a <a href="../api/symbols/Shape.html" target="api">Shape</a>,
whereas the <a href="../api/symbols/Shape.html#fill" target="api">Shape.fill</a> and <a href="../api/symbols/Shape.html#stroke" target="api">Shape.stroke</a> and other shape properties control the colors and appearance of the shape.
For common shape figures, there are predefined geometries that can be used by setting <a href="../api/symbols/Shape.html#figure" target="api">Shape.figure</a>.
However one can also define custom geometries.
</p>
<p>
One can construct any Geometry by allocating and initializing a <a href="../api/symbols/Geometry.html" target="api">Geometry</a> of at least one <a href="../api/symbols/PathFigure.html" target="api">PathFigure</a> holding some <a href="../api/symbols/PathSegment.html" target="api">PathSegment</a>s.
But you may find that using the string representation of a Geometry is easier to write and save in a database.
Use the static method <a href="../api/symbols/Geometry.html#parse" target="api">Geometry.parse</a> or the <a href="../api/symbols/Shape.html#geometryString" target="api">Shape.geometryString</a> property to transform a geometry path string into a <a href="../api/symbols/Geometry.html" target="api">Geometry</a> object.
</p>
<p>
More information can be found in the <a href="../intro/geometry.html">GoJS Intro</a>.
</p>
<p>
<a href="../samples/index.html#geometries">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>