The step property

The step property restricts entered values to multiples of the step (or zero if undefined). The step must be a whole positive integer, and the UI will truncate (not round) an entered value if it contains decimal places beyond that of the step value. A common use case for the step property is to limit inputs to whole numbers.

If the number entered is not a multiple of the step, the setting is not logged immediately, in case the user is entering a value slowly. The value will be reverted to its original value when the user clicks out of the field.

If the number entered is a multiple of the step, an input is logged after a 1-second delay.

Using a rule to set a value that is not a multiple of the step is not recommended. If the user clicks the up or down arrow in the input, the value is changed according to the step value, which may result in an invalid user-entered value.

The following Field Properties dialog illustrates one use of the step property.

The precision property

The precision property displays the number of decimal places provided, regardless of what is entered. When defined, the field will round (not truncate) if decimals are entered beyond the set number of decimal places. (The complete number is saved on the server.) A common use case for the precision property is to display currency in dollars and cents, such as 19.99 or 10.00.

The precision property defaults to 0 if not set.

The following Field Properties dialog illustrates one use of the precision property.

The Display-Type-Specific Constraints Slider

The step property is required for this component. Minimum and maximum values are included, but precision is not.

NumberWithSubmit

The precision property is included and defaults to 0. The step property is not included.