Digital vertical bar
Preconfigured gauge to display any value reading as a vertical bar. Allows to configure value range, gradient colors, and other settings.
Who it’s for
Dashboard builders showing a level or a temperature that crosses zero, in a narrow column on a dark instrument-style board — a row of tank levels, a bank of process temperatures, anything read by comparing heights.
What it does
The Digital vertical bar draws a reading as a glowing segmented column filling from the bottom, colored blue below and red above as the value climbs. Over the default −60 to 60 range the fill crosses from the cool color to the warm one, with the value and a unit caption beside a 2.5×4.5 column that stacks into a row.
- A vertical column matches level, height and temperature, which readers already picture as rising.
- The two-color ramp splits the range into a low half and a high half, which suits a reading that crosses a midpoint rather than climbing toward a single limit.
- A narrow tile is built to be repeated, so a row of columns compares directly.
- Segmented fill and a glow give the instrument-panel look on a dark board.
- Animated movement is on by default, so a drifting value reads as movement.
- Units are converted, not just appended — the gauge respects the unit set on the key and converts to the unit chosen on the widget.
- The Digital vertical bar shows one current reading: it is a styling preset of the same gauge engine as the plain Vertical bar.
How to set up
Data keys
The Digital vertical bar takes one datasource, one entity and one data key.
| Key | Role | Type | Description |
|---|---|---|---|
| Any numeric key | The value the column fills to | Timeseries | Numeric only. An attribute works equally well. The key’s own units and decimals override the widget-level ones. |
Range
| Setting | Default | Effect |
|---|---|---|
| Min value | -60 | The bottom of the column |
| Max value | 60 | The top of the column |
| Units title | On, empty | Caption beside the value; set it to the unit being shown |
| Bar color levels | Blue, red | The ramp the fill moves through |
| Label | Off | The caption above the value, off in this preset |
How to customize
- To match the scale to the measurement — set Min value and Max value; the default crossing-zero range suits temperature and not much else.
- To caption the column — set Units title text, which ships enabled but empty.
- To name the measurement — turn on Label and set its text, which this preset leaves off.
- To put the color change where it means something — edit the Bar color levels so the boundary sits at the value that matters.
- To tune the glow — set Neon glow effect brightness, or
0to remove the effect. - To change how segmented the column looks — adjust Thickness of the stripes, or
0for a solid fill. - To mark a limit on the scale — turn on Ticks and add that value.
- To change the gauge’s shape — set Type to Arc, Donut, Horizontal bar or Vertical bar.
Tips
- Put the color boundary at the midpoint the process actually has, not at the middle of the range. A two-color column is read as “below” and “above”, and readers assume the boundary is meaningful whether or not it was chosen.
- Line up a row of these with a shared range and no per-column captions, naming them in the widget titles instead. Columns of equal scale are compared by height alone, and captions inside each tile break that scan.
Share Your Widget with the Community
Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.