The Number component

Number components let the user enter a number. Several customizations are available.

In addition to the properties listed below, this component inherits properties and methods from the superclass Component. For example, any Number component has a label and defaultValue property even though these are not explicitly listed here.


delimiterWhether or not to show commas as thousands-delimiters.BooleanTrue
decimalLimitMaximum number of decimals the user can enter (or that are shown when the Number is filled some other way). Please note that this does not round the numbers that are entered. It only cuts off all decimals past the specified limit.Integer20
labelPositionPosition of the label with respect to the tags. Can be 'top', 'bottom', 'right-right', 'left-right', 'left-left' or 'right-left'.String"top"
multipleWhether or not multiple values can be entered.BooleanFalse
tableViewWhen true and the component is part of an EditGrid, the component's value is shown (simplified) in the collapsed row of the EditGrid.BooleanFalse
validateThis property of the Component is very useful for validating numbers:
  • validate.min/validate.max: The bounds of the number the user can enter.
  • validate.step: The granularity of the input number.
  • validate.integer: Whether or not the number must be an integer.

The Number component does not support exponential notation. In order to specify numbers in scientific notation, use a TextField component with custom validation.

See also

  • Use Validate to set things like min/max values for the Number component.