Skip to main content

Number Input Widget

⚡ Control

The Number Input widget provides a text field pre-validated for numeric input. Users type a value directly and press Send (or Enter). Useful when Slider precision isn't enough or when the range is very large (e.g. frequency in Hz, timestamps, large counts).

Default size: 2 × 2 grid cells


Configuration

PropertyTypeDefaultDescription
minnumber0Input minimum (rejects values below)
maxnumber1000Input maximum (rejects values above)
stepnumber1Increment used by ▲/▼ spin buttons
placeholderstringEnter valueHint text when empty
unitstring``Unit suffix shown inside the field
DevicedeviceThe device to write to
PinV0V255The virtual pin to write
LabelstringWidget label

Firmware example

VWIRE_RECEIVE(V0) {
long freq = param.asLong(); // e.g. 433920000
setRadioFrequency(freq);
Vwire.virtualSend(V0, freq); // echo confirmed value
}

Difference from Slider

FeatureSliderNumber Input
Input methodDragType / spin
Best forRange ≤ 1000Large or non-linear ranges
PrecisionStep-limitedFull numeric precision
Screen footprint3×1 (wide)2×2 (compact)

Validation

Values outside [min, max] are highlighted in red and not sent until corrected.
Non-numeric input is silently rejected.