Skip to content

Number Input

A numeric input field with optional min/max bounds and step increment. Renders as an HTML <input type="number">.

Properties

PropertyTypeDefaultDescription
nametext''The field name. Must match your database column name.
labeltext''The visible label displayed above the input.
minnumber''Minimum allowed value. Leave empty for no minimum.
maxnumber''Maximum allowed value. Leave empty for no maximum.
stepnumber''The increment step (e.g., 1 for integers, 0.01 for currency).
placeholdertext''Placeholder text shown when the input is empty.
requiredbooleanfalseWhether the field is required for form submission.
valuetext''Pre-populate the input with a value. Supports expression binding (e.g., {{ item.price }}).

Events

  • onChange -- Fires when the value changes.
  • onBlur -- Fires when the input loses focus.
  • onFocus -- Fires when the input gains focus.

Example

A price field:

name: price
label: Price ($)
min: 0
max: 99999
step: 0.01

A quantity selector:

name: quantity
label: Quantity
min: 1
max: 100
step: 1

An edit form field pre-populated with an existing value:

name: price
label: Price ($)
value: "{{ item.price }}"
placeholder: Enter price
required: true
min: 0
step: 0.01

Tips

  • Place inside a Form Container for the value to be included in form submissions.
  • The step property controls the increment when using the browser's up/down arrows. Set 0.01 for decimal precision or 1 for whole numbers.
  • Users can still type values outside the min/max range -- always validate server-side with a Validate node.
  • Use for prices (decimal columns), quantities (int columns), ratings, ages, or any numeric data.