Skip to main content
Version: 0.43

Number Field

The Number Field component is a numeric input, letting users enter and edit numbers with a configurable minimum/maximum range and an increment step, with optional high-precision decimal support. When the form is read-only, it displays the number pre-formatted instead of as an editable input.

Image


Properties​

The following properties are available to configure the behavior of the component from the form editor (this is in addition to common properties).

Display​

Property Name string​

Only properties whose data type is a number are offered when browsing entity properties to bind to.

Binding fills in Min/Max automatically

When Property Name is bound to an entity property, Min Value and Max Value (in the Validation panel below), along with the component's Label and Description, are pre-filled from that property's own metadata - you don't need to set them manually unless you want to override them.

Label Align object​

Number Field-specific left/right alignment choice for the label text.

High Precision boolean​

Switches the input to string-based numeric handling, for entering decimals with more precision than standard floating-point numbers safely support.

Step number / string​

How much the value changes per click of the input's up/down arrows. This field changes type depending on High Precision: a plain number field when High Precision is off (default 1), or a text field when High Precision is on (default "0.1").

Step value while High Precision is on

The Step text field shown while High Precision is on is not actually read by the component - the step used at runtime always comes from the numeric Step value that was set while High Precision was off. If you need a specific step (e.g. 0.01) with High Precision enabled, temporarily turn High Precision off, set the numeric Step, then turn High Precision back on.

Hide Label boolean​

Hides the component's label without hiding the component itself.

Hide Border boolean​

Removes the input's border, rendering it borderless.


Data​

Default Value number​

A default numeric value used when the form has no existing value for this field. Evaluated as a script with formData, formMode, and globalState exposed.


Events​

On Change function​

Fires when the value changes. Alongside the standard event variables, value (the component's current value) is also exposed.


Validation​

Min Value / Max Value number​

Restrict entries to within a specified numeric range.