Skip to main content

Number

A number field allowing the user to read and edit numeric data.

Form Number Symbol

Configurable properties​

  • Field label: Label displayed on top of the number field.
  • Field description: Description provided below the number field.
  • Key: Binds the field to a form variable, see data binding docs.
  • Default value: Provides a default value for the number field in case no input data exists for the given key.
  • Decimal digits: Defines the maximum number of digits after the decimal.
  • Increment: Defines the increment between valid field values.
  • Disabled: Disables the number field, for use during development.
  • Hide if: Expression to hide the number.
  • Columns: Space the field will use inside its row. Auto means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the Carbon Grid documentation.
  • Serialize to string: Configures the output format of the datetime value. This enables unlimited precision digits.
  • Validation: Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.
    • Required: Number field must contain a value.
    • Minimum: Number field value must be at least n.
    • Maximum: Number field value must be no larger than n.
  • Appearance: Changes the visual appearance of the number field.
    • Prefix: Adds an appendage before the input.
    • Suffix: Adds an appendage after the input.

Datatypes​

Number can be bound to numeric data, or strings which can be parsed to numeric data (as per JavaScript's tryParse), but will always output strictly integer data.