node-red-contrib-ui-level is a custom Node-RED node designed to provide a linear level indicator widget for the Node-RED Dashboard. It enables users to visually represent numerical data as a customizable bar graph. The current stable version provided is 0.1.46. This node is part of the Node-RED ecosystem, typically seeing updates driven by Node-RED and Node-RED Dashboard releases, and new feature additions. Key differentiators include its support for three layouts (Single Horizontal, Pair Horizontal, Single Vertical), extensive color customization options (multiple segments, single color, interpolated), an optional 'Peak mode' with adjustable hold times, and dynamic configuration of properties like min/max values, segments, and labels via `msg.control` inputs. It also offers multiple stripe resolutions and animation options, providing flexibility for various dashboard designs.
npm install node-red-contrib-ui-levelVerified import paths — ran on the pinned version, not inferred.
This conceptual code demonstrates how `msg.payload` and `msg.control` properties are structured and sent to a Node-RED UI Level node to update its display, dynamically adjust parameters, and control features like peak mode.
Disable 'Animation of value text' in the node's configuration if performance issues are observed.
Configure individual channel labels within the node properties for 'Pair Horizontal' layout or use `msg.control = { label: 'New Label for channel X' }` for dynamic updates.Increase the widget's size in the Node-RED Dashboard layout, or adjust text size options within the `ui-level` node configuration.
Ensure `msg.control` is an object containing valid keys like `min`, `max`, `seg1`, `seg2`, `seg3`, `label`, or `peakreset`, as specified in the documentation.
Install the package via 'Manage palette' in the Node-RED editor or run `npm install node-red-contrib-ui-level` in your Node-RED user directory and restart Node-RED.
Ensure `msg.payload` contains a number or a string representing a number (e.g., `msg.payload = 15` or `msg.payload = "15"`). Check the node's configuration for correct `min` and `max` settings.
Increase the widget's size in the Node-RED Dashboard layout, or adjust text size options within the `ui-level` node configuration.