node-red-contrib-ui-led
Version:
A simple LED status indicator for the Node-RED Dashboard
87 lines (52 loc) • 3.99 kB
Markdown
# Node-RED UI LED
A simple LED status indicator for the Node-RED Dashboard
[](https://app.fossa.io/projects/git%2Bgithub.com%2FAdorkable%2Fnode-red-contrib-ui-led?ref=badge_shield)
[](https://github.com/Adorkable/node-red-contrib-ui-led/network/dependencies)
[](https://github.com/Adorkable/node-red-contrib-ui-led/network/dependencies)
[](https://github.com/Adorkable/node-red-contrib-ui-led/network/dependencies)
[](https://github.com/Adorkable/node-red-contrib-ui-led/network/dependencies)
The node uses `msg.payload`'s value to determine status. By default:
- `msg.payload` === `true` - **Green**
- `msg.payload` === `false` - **Red**
- no `msg` received yet or `msg.payload` !== `true` and `msg.payload` !== `false` - **Gray**
## Install
To install the node run the following from your Node-RED user directory (`~/.node-red`):
```bash
npm install node-red-contrib-ui-led
```
Or install the node from the Palette section of your Node-RED editor by searching by name (`node-red-contrib-ui-led`).
## Aesthetics
There are a number of options when it comes to the node's aesthetics.
<br/>
<div style='display: flex;'>
<span style='margin-right: 10px; width: 50%'>By default the LED itself will grow and shrink to fit the vertical height of the space it is locked to, auto-size to fit the group if marked `auto`.</span>
<img src="./images/sizes.png" alt="Sizes" width="300px"/>
</div>
<br/>
Most other customization happens in the **Edit panel**, which includes a preview so you can tweak to your heart's content.
## Custom Statuses
Although `true` => Green and `false` => Red is the default, one can map other payload values to any color.
To customize the mappings open the node's configuration panel and scroll to the _Colors for Values_ list.
To add a value mapping press the **+Color** button at the bottom of the list.
Next fill in a color in a [CSS](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value) format (color name, hex, rgb, rgba...), select the value type (`string`, `boolean`...) and fill in an appropriate value.
Similarly existing Value => Color maps can be modified.
Finally to delete a mapping simply press the X button on the far right!
## Custom Statuses in `msg`
By enabling _Allow Color For Value map in msg_ in a node that node will use dictionaries passed via `msg.colorForValue` to override any previous color to value mappings.
The format should be `value` => `color`, ie an object whose key values return color values.
Example:
```js
msg.colorForValue = {}
msg.colorForValue[true] = 'purple'
msg.colorForValue[false] = 'orange'
```
## Further Examples
To see usages already set up check out the examples included with the project by using _Import_ in your Node-RED editor!
## License
[](https://app.fossa.io/projects/git%2Bgithub.com%2FAdorkable%2Fnode-red-contrib-ui-led?ref=badge_large)
## Thanks to
- [@alexk111](https://github.com/alexk111) for his great [Node-RED Typescript Starter](https://github.com/alexk111/node-red-node-typescript-starter) which made it a breeze to convert the project over to Typescript