Widgets / directory

Segmented Control

SEGMENTED_CONTROL

Compact index selector for modes, presets and scene families.

At a glance

Default8 x 1
Minimum4 x 1
Resizeboth
Pinrequired
Interactiveyes

Behavior

  • Strong fit for compact dashboards with limited vertical room.
  • Visually closer to console tabs than a dropdown menu.
  • Often controls filter modes or source routing.

Firmware contract

Treat the incoming value as a selected segment index.

On the app side this widget snaps to the 8-column square grid and uses both resizing. Its raw type is SEGMENTED_CONTROL and the matching icon token in the app is square.split.1x2.fill.

Pin support: A configured pin is required before the widget becomes meaningful.

Transmission: Payload format depends on the widget type and the selected pinType.

Canvas preview

docs.widget.preview
Segmented Control

Widget contract

PropertyValue
Raw typeSEGMENTED_CONTROL
Default size8 x 1
Minimum size4 x 1
Resize modeboth
Pin requirementrequired
Pin supportSee behavior and firmware contract above
Interactiveyes
TransmissionDepends on the widget payload type

Allowed pin families

Bound to the configured pinType and limited by how the current app/connector serialize the widget payload.

Transport path

Payload leaves the canvas through the dashboard transport and lands on the selected virtual, digital or analog endpoint.

Operational limits

Server-side behavior may still depend on board library support and project policy.

Configuration surface

  • Color, label and position are stored in the dashboard profile.
  • Use the app-side widget config sheet to tune behavior per widget type.

Limits and caveats

  • Server-side behavior may still depend on board library support and project policy.

Layout notes

Canvas footprint

8 x 1

Default footprint in the Plynx canvas before user resizing.

Resize floor

4 x 1

The minimum size accepted by the app during drag-resize.

Interaction model

Live input

Whether the user edits state directly or only reads it.

Related widgets