Skip to main content

Number

The number field allows users to input numeric values. This field is ideal for scenarios like setting quantities, entering prices, or defining numeric parameters.

Example

fields:
  quantity:
    type: number
    label: Enter Quantity
    min: 1
    max: 10
    step: 1

Field Properties

Name Type Default Description
aria string –

Optional aria label for better accessibility.
autofocus bool false

Set autofocus on field.
error string | array –

Costum error message for translation or customization.
help string | array –

Optional help text below the field
label string | array –

The field label can be set as string or associative array with translations
max int –

Defines the maximum allowable value for the field.
min int –

Defines the minimum allowable value for the field.
placeholder string | array –

Optional placeholder value that will be shown when the field is empty.
required bool –

Defines whether the field is mandatory for form submission.
step int 1

Specifies the step size for numeric input, determining the increments or decrements.
title string | array –

Tooltip displayed when the user hovers over the field (supports multilingual configurations).
width string 1/1

The width of the field in the 12 columns field grid.

Validation Logic

The number field automatically enforces:

  • Minimum Value min: Ensures the input is not smaller than the specified min value.
  • Maximum Value max: Ensures the input does not exceed the max value.
  • Step step: Validates that the input adheres to the defined step increments.