Docs
Widgets / directory

Menu

MENU

Dropdown or picker surface that sends the selected item index.

At a glance

Default4 x 2
Minimum2 x 1
Resizeboth
Pinrequired
Interactiveyes

Behavior

  • Best when the number of states is larger than a segmented control can hold.
  • Useful for mode sets, source selectors and filter banks.
  • Keeps the canvas cleaner than many dedicated buttons.

Firmware contract

Map selected menu item indexes to operating modes on the board.

On the app side this widget snaps to the 8-column square grid and uses both resizing. Its raw type is MENU and the matching icon token in the app is list.bullet.

Pin support: Usually virtual pins carrying a selected index.

Transmission: Single integer index representing the selected label entry.

Canvas preview

docs.widget.preview
Mode B
4 items
Menu
stable
STATUS

Widget contract

PropertyValue
Raw typeMENU
Default size4 x 2
Minimum size2 x 1
Resize modeboth
Pin requirementrequired
Pin supportUsually virtual pins carrying a selected index.
Interactiveyes
TransmissionSingle integer index representing the selected label entry.

Allowed pin families

Usually virtual pins carrying a selected index.

Transport path

Single integer index representing the selected label entry.

Operational limits

Does not expose the full label text to firmware, only the selected index/value mapping

Configuration surface

  • labels array defines the visible choices
  • best paired with concise labels because the footprint is small

Limits and caveats

  • Does not expose the full label text to firmware, only the selected index/value mapping

Layout notes

Canvas footprint

4 x 2

Default footprint in the Plynx canvas before user resizing.

Resize floor

2 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

Button

Momentary or toggle actuator for a single virtual or hardware pin.

Styled Button

A richer button with distinct on/off labels and color states.

Slider

Horizontal continuous input with min, max and send strategy options.

Vertical Slider

Vertical range control for compact side panels and console-style layouts.