Docs
Widgets / directory

Number Input

NUMBER_INPUT

Numeric input with min/max constraints and compact keypad-driven editing.

At a glance

Default4 x 2
Minimum3 x 1
Resizeboth
Pinrequired
Interactiveyes

Behavior

  • A precise alternative to sliders when exact values matter.
  • Works well for PID parameters, thresholds and calibration constants.
  • Pairs with Step for rough/fine adjustment flows.

Firmware contract

Parse the incoming value as integer or float depending on the configured range.

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

Pin support: Virtual, digital or analog depending on pinType.

Transmission: Single numeric payload, usually scalar integer in the current widget set.

Canvas preview

docs.widget.preview
42
Number Input
stable
STATUS

Widget contract

PropertyValue
Raw typeNUMBER_INPUT
Default size4 x 2
Minimum size3 x 1
Resize modeboth
Pin requirementrequired
Pin supportVirtual, digital or analog depending on pinType.
Interactiveyes
TransmissionSingle numeric payload, usually scalar integer in the current widget set.

Allowed pin families

Virtual, digital or analog depending on pinType.

Transport path

Single numeric payload, usually scalar integer in the current widget set.

Operational limits

Still needs board-side validation for dangerous ranges

Configuration surface

  • min/max clamp manual entry
  • step defines increment buttons or validation granularity

Limits and caveats

  • Still needs board-side validation for dangerous ranges
  • Integer coercion can hide fractional intent if not configured carefully

Layout notes

Canvas footprint

4 x 2

Default footprint in the Plynx canvas before user resizing.

Resize floor

3 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.