# Node-RED UI LED A simple LED status indicator for the Node-RED Dashboard ![CI](https://github.com/Adorkable/node-red-contrib-ui-led/workflows/CI/badge.svg) [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FAdorkable%2Fnode-red-contrib-ui-led.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2FAdorkable%2Fnode-red-contrib-ui-led?ref=badge_shield) [![dependencies](https://img.shields.io/david/adorkable/node-red-contrib-ui-led.svg?style=flat-square)](https://github.com/Adorkable/node-red-contrib-ui-led/network/dependencies) [![peer-dependencies](https://img.shields.io/david/peer/adorkable/node-red-contrib-ui-led.svg?style=flat-square)](https://github.com/Adorkable/node-red-contrib-ui-led/network/dependencies) [![dev-dependencies](https://img.shields.io/david/dev/adorkable/node-red-contrib-ui-led.svg?style=flat-square)](https://github.com/Adorkable/node-red-contrib-ui-led/network/dependencies) [![optional-dependencies](https://img.shields.io/david/optional/adorkable/node-red-contrib-ui-led.svg?style=flat-square)](https://github.com/Adorkable/node-red-contrib-ui-led/network/dependencies) ![Examples Image](images/examples.png) 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.
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`. Sizes

Most other customization happens in the **Edit panel**, which includes a preview so you can tweak to your heart's content. ![Edit panel](images/preview_changes.gif) ## 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. ![Colors for Values Image](images/colorsForValues.png) 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 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FAdorkable%2Fnode-red-contrib-ui-led.svg?type=large)](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