Interactive (control) widgets
Some widgets write to a device or trigger an action:
- command-button — sends a one-shot Modbus write (a function-code command).
- toggle-switch — flips a coil on/off (Modbus FC05). Great for relays.
- slider-control — writes a register value (Modbus FC06). Great for setpoints or PWM duty.
- action-button — fires a saved User Action (webhook or MQTT) via its
actionId.
Realistic control widgets
Skeuomorphic controls with the same write behaviour, for a more tactile HMI:
- rocker-switch — a realistic industrial bat-handle or rocker toggle. Same options as toggle-switch (Modbus FC05/FC06 or a User Action), plus a
styleand on/off colours. - illuminated-button — a lit momentary (on-while-held) or latching push-button, or an emergency-stop style. Writes Modbus or fires an action; the lamp can reflect the live data stream (
feedbackFromData). - rotary-knob — turn (drag or scroll) to set a value; writes the holding register (FC06) when you release.
- selector-switch — a multi-position rotary selector (e.g. Off / Manual / Auto). Each position writes its own coded value — edit the positions under Configuration → Positions.
- fan-speed-selector — a multi-speed fan control (Off / Low / Med / High) with a live fan; each speed writes its value.
When you operate a control widget you'll see device/write then device/write/ack events confirming the device acted. Controls require a writable device/protocol (e.g. a Modbus coil/register or a gpio-digital-out/gpio-pwm device). Widgets that fire a User Action instead need a saved action and don't require a writable Modbus device.