Icon Button
A switch drawn as a single large icon with its label below. The icon lights up when the circuit is on and is grey when it is off. While a command is on its way, a spinner takes its place. If the command fails, the reason shows in red under the label, for example No response from data-link.
Add it
In edit mode, tap Add Content, open the switches tab and choose Icon Button. It needs at least 4 by 4 cells and starts in Toggle mode.
Choose an icon on the ICON tab. Until you do, the button shows a power icon.
On the DESIGN tab, Icon Size runs from x-small to x-large.
Settings
See Widget settings. The switch widget has these tabs:
- DESIGN: Button Style, the size, Button Color (Primary, Info, Warning, Alarm or Success), and a Preview. Changing Button Style turns this widget into another of the four switch styles and keeps its size.
- INFO: label and label 2, the two lines of text.
- ICON: the icon.
- SWITCH: Button Mode, below, and Connection Type, the equipment the button drives. The switches themselves are set up once, in the Setup app; see Switches.
- DATALINK: only for connections that need a value to show whether the circuit is on.
Button modes
| Button Mode | What a tap does |
|---|---|
| On / Off | Switches the circuit on, or off if it is on. |
| Toggle | Sends one command; the equipment changes over by itself. |
| Pulse | Switches on, and off again a quarter of a second later. |
| Push | On while you hold the button, off when you let go. |

