Stepper

An increment/decrement numeric control. Stores a .number value.

Type

"stepper"

Relevant Fields

Inherits all Control Definition. Key fields:

Field Type Default Description
min number 0 Minimum value
max number 100 Maximum value
step number 1 Increment/decrement amount
label string — Display label
icon string — SF Symbol before value
formatValue string "decimal" Value format: "decimal", "time", "percent"
defaultValue number — Initial value
haptic string "light" Default haptic on step

Example

{
  "type": "stepper",
  "id": "target-temp",
  "position": [1, 0],
  "span": [1, 2],
  "min": 60,
  "max": 85,
  "step": 1,
  "defaultValue": 72,
  "label": "Target °F",
  "action": { "method": "meshsocket", "mode": "request", "event": "route_msg", "payload": { "target_id": "ecobee", "type": "set_temp", "payload": { "target": "{{value}}" } } }
}

Behavior

  • Displays current value with animated numeric transition
  • +/- buttons respect min/max bounds
  • Fires action on each increment/decrement