Zones

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.

Live preview · sample data

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

FieldWhat it does
EntityThe value to read. It should be a string, one piece per zone
DelimiterWhat separates the zones. Leave it empty for one zone per character
LabelText beside the row
Label positionWhich 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 positionWhere that number sits — above the box, to its left, or inside it
Animate changesA 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 breakBreak there whatever the column’s width. Off: only when the row runs out of room
StatesA character, a color and Show index, one per state. Add state for another
All othersThe color for a zone whose character none of your states names, and whether those are numbered
Admin onlyHide 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.