Zones
Shows one box per zone, colored by the state that zone is in, read out of a single string your device sends. Where a Switch is one thing and a Bar graph compares numbers, Zones answers “which of these are on?” at a glance.
Built for devices that report several like things at once — the zones of an alarm panel, the relays on a board, the valves on a manifold.
Zones are numbered from 1, left to right, and each state decides whether its zones show that number — above, only the open ones do, so the row stays quiet until something happens. Hover any box to see its number and the value it received.
Settings
| Field | What it does |
|---|---|
| Entity | The value to read. It should be a string, one piece per zone |
| Delimiter | What separates the zones. Leave it empty for one zone per character |
| Label | Text beside the row |
| Label position | Which side the label sits on — top, left or right |
| Box size (px) | The edge of one box |
| Gap (px) | The space between boxes. Rows that wrap sit a little further apart than that |
| Number size (px) | How big the zone number on each box is |
| Number position | Where that number sits — above the box, to its left, or inside it |
| Animate changes | A box fades to its new color and blinks as it changes |
| Break after (boxes) | How many boxes before a new row. Empty fits as many as the column allows |
| Always break | Break there whatever the column’s width. Off: only when the row runs out of room |
| States | A character, a color and Show index, one per state. Add state for another |
| All others | The color for a zone whose character none of your states names, and whether those are numbered |
| Admin only | Hide it from everyone who isn’t an admin of the device — see Sharing a device |
This element only shows — it sends nothing. Tapping a box does not change anything on the device.
The delimiter
A device usually fences its zones with the delimiter at each end, and these four all mean the same four zones:
|_|_|_|_| |_|_|_|_ _|_|_|_| _|_|_|_An empty piece at either end is a fence, not a zone, so it’s dropped. One in the middle is
kept and drawn — if your device sends _||_ it means something by it, and that zone takes the
All others color.
Set the delimiter to whatever your firmware uses — |, a comma, even a multi-character
separator like , . Spaces around a piece are ignored, so _, 1, X with a , delimiter reads
as three zones.
Why “All others” exists
A state list names the characters you expect. Some devices don’t send a fixed character for every state.
The alarm panel in the demo above is one: a closed zone is _, a disabled zone X and a
bypassed zone B — but an open zone is marked with its own number. Zone 3 open reads 3,
zone 10 open reads 10. You could never list all of those as states, and you don’t have to:
set _, X and B as states, give All others your alarm color, and every open zone
turns that color whatever number it carries.
If your device does send a fixed character for every state, list them all and All others simply never shows — then it tells you something too, because a box in that color means the device sent something you weren’t expecting.
Tips
Break after decides where a long row goes onto the next line — eight, sixteen, whatever your panel counts in. Tick Always break and it breaks there whatever the column’s width, so sixteen zones read as two tidy rows of eight. Leave it off and the row fills the column and wraps only when it runs out of room. Either way a column too narrow for the break point breaks earlier instead: a box is never cut off.
Widen the column if you’d rather have one long row. A column is 150px unless you change it — set a width that fits your zones, or tick Auto Width, in the Edit column tab.
Box size and gap are worth tuning for the count. Sixteen relays read better at a smaller size with a tighter gap than four do.
Show index per state is what keeps a long row readable. A number over every box is noise when most zones sit in the same resting state all day; tick it only on the states that mean something — for the alarm above, that’s All others, which is what an open zone matches — and a number appears exactly where you need to read one off. The line above the boxes is kept whatever the zones are doing, so nothing shifts as they change; untick it everywhere and the line goes too.
Number position moves those numbers when the line above the boxes is in the way. Top is the default. Left sets each number beside its box instead, which suits a short row where a line of numbers would be half the card’s height; the numbers get a column of their own, so the boxes still line up whether a zone is 1 or 16. Center puts the number inside the box, where it costs no room at all — the box’s color is then the only thing marking the state, so the number is drawn in black or white, whichever reads on that color. Either of those two drops the space above the boxes, and wrapped rows close up to the plain Gap as well.
A zone that changes fades to its new color and swells for a moment, so it catches the eye even if you weren’t looking straight at it. Untick Animate changes if the element would rather sit still — worth it for a row that changes every few seconds, where the movement stops being a cue. Either way it is dropped for anyone whose system asks for reduced motion.