Skip to main content
Category: Display · Reads data: yes · Sends commands: via triggers

​
Mental model

A Label is a nameplate — or a digital readout. Use it for static text (a title, a caption) or to show a live value pushed from a device. It’s the most heavily styleable widget, with full typography and effects.

​
When to use it

  • Titles, captions, and static text
  • A simple live value readout (27.4 °C)

​
Settings

​
General / Data

  • Widget Title / ID · text or bound value

​
Style

The richest style set: angle, animation / animation type, backdrop filter, blur, blend mode, box shadow, border (color / width / radius / style), background, and full typography.

​
Triggers

click, hover, plus the common lifecycle events.

​
Example — live readout from firmware

device.updateWidget(targetId, "tempLabel", String(temperature) + " °C");

​
Script API example

The same interactions from a dashboard script: 
// Live clock
setInterval(() => {
  widget.setText('clock-label', new Date().toLocaleTimeString());
}, 1000);

Status

For a colored state instead of plain text.