Registry / devops / node-red-contrib-ui-artless-gauge

node-red-contrib-ui-artless-gauge

library0.3.12jsnpmunverified

A Node-RED Dashboard UI widget providing a minimal gauge with linear and radial layouts. Version 0.3.12, stable, periodic updates. Supports regular and differential modes, configurable segments, animation, dashed lines, and various icon sets (Font Awesome, Material, Weather Icons Lite, Iconify). Differentiates from alternatives like ui-gauge by offering a cleaner design, differential mode, and more customization for line styles.

devops

npm install node-red-contrib-ui-artless-gauge

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · NODE-RED-CONTRIB-U

node-red-contrib-ui-artless-gauge

devopsjavascriptv0.3.12

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

node-red-contrib-ui-artless-gauge

✓ Install via Node-RED palette manager or npm i node-red-contrib-ui-artless-gauge

✗ Attempting to import JavaScript modules directly (it's a Node-RED node, not a JS library)

This is a Node-RED custom node, not a standard JavaScript module. Import via Node-RED's palette or npm install.

Shows installation and basic usage of the gauge node in Node-RED with a flow example.

// No code import needed. Install package in Node-RED. // 1. In Node-RED, go to Manage Palette > Install > search 'node-red-contrib-ui-artless-gauge' and install. // 2. Drag 'artless gauge' node from dashboard category onto workspace. // 3. Configure properties (size, layout, range, etc.) in the node's edit dialog. // 4. Wire an input node (e.g., inject) sending msg.payload as a number. // Example flow JSON: [{"id":"n1","type":"inject","z":"flow","name":"","props":[{"p":"payload"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"50","payloadType":"num"},{"id":"n2","type":"ui_artless_gauge","z":"flow","group":"Group","name":"My Gauge","order":1,"width":6,"height":4,"label":"Speed","icon":"fa-tachometer","layout":"radial","mode":"normal","min":0,"max":100,"segments":[],"animation":true,"lineWidth":10,"lineStyle":"","trackColor":"#ccc","tickmarks":true,"round":0,"format":"{{value}}","x":300,"y":200,"wires":[]}] // Then deploy and see gauge on dashboard.

Debug

Known issues

breakingNode-RED Dashboard must be installed separately; this node does not install it automatically.

fix

Install node-red-dashboard via npm or Palette Manager.

affects: >=0.0.0

gotchaLabel field does not support HTML; only plain text is allowed.

fix

Use plain text in 'Label' field; for rich text, consider alternative nodes.

affects: >=0.0.0

gotchaRadial layout forces square dimensions based on shortest side; minimum 2x2 units.

fix

Set width and height to same value for predictable radial gauge size.

affects: >=0.0.0

gotchaIconify icons require internet and a script added to dashboard site head.

fix

Add <script src="https://code.iconify.design/1/1.0.7/iconify.min.js"></script> to dashboard.

affects: >=0.0.0

gotchaAnimate option can cause performance issues on slow devices when enabled.

fix

Disable animation if gauge is jittery or dashboard is unresponsive.

affects: >=0.0.0

gotchaLine width range depends on layout and configured size; not documented precisely.

fix

Experiment with values; if gauge looks odd, adjust line width.

affects: >=0.0.0

gotchaDashed line 'round' option at end of dash array may not work in all browsers.

fix

Test in target browsers; use 'round' only if supported via stroke-linecap attribute.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'node-red-contrib-ui-artless-gauge'

Package not installed in Node-RED node_modules.

fix

Install via npm: npm install node-red-contrib-ui-artless-gauge, or use Node-RED Palette Manager.

TypeError: Cannot read properties of undefined (reading 'payload')

Input payload is undefined or missing.

fix

Ensure msg.payload is a number before passing to gauge node.

Gauge not appearing on dashboard

Dashboard group not configured or node not wired to UI.

fix

Create a UI group in Node-RED Dashboard settings and assign gauge node to a group.

Icon not showing

Icon set not loaded or incorrect icon name.

fix

Use correct Font Awesome 4.7 or Material icon name. For Iconify use prefix 'iconify-' and ensure script is added.

Gauge size not as expected

Radial layout enforces square based on smallest dimension.

fix

Set width and height equal or accept that the gauge will be square.

Upgrade

Version history

0.3.12latest on npm

Audit

Dependencies

node-red-dashboardrequiredRequired to register the widget in Node-RED Dashboard UI

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/hotNipi/node-red-contrib-ui-artless-gauge ↗

packagenode-red-contrib-ui-artless-gauge ↗

homepagehttps://github.com/hotNipi/node-red-contrib-ui-artless-gauge#readme ↗