Docs

Documentation versions (currently viewingVaadin 14)

You are viewing documentation for an older Vaadin version. View latest documentation

Number Field

Number Field sports many of the same features as Text Field but only accepts numeric input.

The input can be decimal, integral or big decimal.

You can specify a unit as a prefix or suffix for the field.

Open in a
new tab
Source code
NumberFieldBasic.java

Common Input Field Features

Number Field includes all Text Field and shared input field features.

Stepper Controls

Stepper controls allow the user to quickly make small adjustments.

Open in a
new tab
Source code
NumberFieldStepperControls.java

Minimum & Maximum Value

The valid input range of a Number Field can be set by defining minimum and maximum values.

You can set the Helper text to instruct about the range.

Open in a
new tab
Source code
NumberFieldMinMax.java

Step

The step value of a Number Field defines the allowed number intervals.

It specifies the amount by which the value increases/decreases when using the Up/Down arrow keys or the stepper controls.

It also invalidates the field if an entered value does not align with the specified step.

Open in a
new tab
Source code
NumberFieldStep.java

Number Type Variants

Integer Field

To only allow entering integer numbers, you can use the Integer Field:

Open in a
new tab
Source code
NumberFieldInteger.java

BigDecimal Field

Java developers that need to support the BigDecimal type can use Big Decimal Field:

Open in a
new tab
Source code
NumberFieldBigDecimal.java

Best Practices

Number Field should be used for actual number values such as counts and measures. Do not use it for other digit-based values such as telephone, credit card, and social security numbers. These values can have leading zeros and be greater than Number Field’s maximum supported value.

When applicable, set the most common choice as the default value. For example, airline, bus, train and other travel companies typically default the number of passengers to 1.

5CF5DB80-A237-424D-9276-C7B79614997B