> Markdown version of [Number Field](https://vaadin.com/docs/v23/components/number-field). Section index: [llms.txt](https://vaadin.com/docs/v23/components/llms.txt)

# Number Field

Number Field has many of the same features as Text Field, but it accepts only numeric input.

The input can be a decimal, an [integer](#integer-field) or a [big decimal](#bigdecimal-field).

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

**TypeScript** — `number-field-basic.ts`

```typescript
<vaadin-number-field label="Balance" value="200">
  <div slot="prefix">$</div>
</vaadin-number-field>

<vaadin-number-field label="Balance" value="200">
  <div slot="suffix">€</div>
</vaadin-number-field>
```

**Java** — `NumberFieldBasic.java`

```java
NumberField dollarField = new NumberField();
dollarField.setLabel("Balance");
dollarField.setValue(200.0);
Div dollarPrefix = new Div();
dollarPrefix.setText("$");
dollarField.setPrefixComponent(dollarPrefix);

NumberField euroField = new NumberField();
euroField.setLabel("Balance");
euroField.setValue(200.0);
Div euroSuffix = new Div();
euroSuffix.setText("€");
euroField.setSuffixComponent(euroSuffix);

add(dollarField, euroField);
```

## <a id="common-input-field-features"></a>Common Input Field Features

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

- [See Text Field features](https://vaadin.com/docs/v23/components/text-field.md)

- [See shared input field features](https://vaadin.com/docs/v23/components/input-fields.md)

## <a id="step-buttons"></a>Step Buttons

Step buttons allow the user to make small adjustments, quickly.

**TypeScript** — `number-field-step-buttons.ts`

```typescript
<vaadin-integer-field
  value="2"
  step-buttons-visible
  min="0"
  max="9"
></vaadin-integer-field>
```

**Java** — `NumberFieldStepButtons.java`

```java
IntegerField adultsField = new IntegerField();
adultsField.setValue(2);
adultsField.setStepButtonsVisible(true);
adultsField.setMin(0);
adultsField.setMax(9);
```

## <a id="minimum-and-maximum-value"></a>Minimum and Maximum Value

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

You can set the [Helper](https://vaadin.com/docs/v23/components/input-fields.md#helper) text to give information about the range.

**TypeScript** — `number-field-min-max.ts`

```typescript
<vaadin-integer-field
  label="Quantity"
  helper-text="Max 10 items"
  min="0"
  max="10"
  value="2"
  step-buttons-visible
></vaadin-integer-field>
```

**Java** — `NumberFieldMinMax.java`

```java
IntegerField integerField = new IntegerField();
integerField.setLabel("Quantity");
integerField.setHelperText("Max 10 items");
integerField.setMin(0);
integerField.setMax(10);
integerField.setValue(2);
integerField.setStepButtonsVisible(true);
add(integerField);
```

## <a id="step"></a>Step

The step value of a Number Field defines the numeric intervals that are allowed.

It specifies the amount by which the value increases or decreases when using the Up or Down arrow keys, or the step buttons.

It also invalidates the field if the value entered doesn’t align with the specified step.

**TypeScript** — `number-field-step.ts`

```typescript
<vaadin-number-field
  label="Duration (hours)"
  step="0.5"
  value="12.5"
  step-buttons-visible
></vaadin-number-field>
```

**Java** — `NumberFieldStep.java`

```java
NumberField numberField = new NumberField();
numberField.setLabel("Duration (hours)");
numberField.setStep(0.5);
numberField.setValue(12.5);
numberField.setStepButtonsVisible(true);
add(numberField);
```

## <a id="number-type-variants"></a>Number Type Variants

### <a id="integer-field"></a>Integer Field

To allow only integers to be entered, you can use the Integer Field like so:

**TypeScript** — `number-field-integer.ts`

```typescript
<vaadin-integer-field label="X" value="-1284"></vaadin-integer-field>

<vaadin-integer-field label="Y" value="3910"></vaadin-integer-field>
```

**Java** — `NumberFieldInteger.java`

```java
IntegerField xField = new IntegerField();
xField.setLabel("X");
xField.setValue(-1284);

IntegerField yField = new IntegerField();
yField.setLabel("Y");
yField.setValue(3910);

add(xField, yField);
```

### <a id="bigdecimal-field"></a>BigDecimal Field

Java developers who need to support the [BigDecimal](https://docs.oracle.com/javase/8/docs/api/java/math/BigDecimal.html) type can use Big Decimal Field:

**Java** — `NumberFieldBigDecimal.java`

```java
BigDecimalField bigDecimalField = new BigDecimalField();
bigDecimalField.setLabel("Result");
bigDecimalField.setWidth("240px");
bigDecimalField.setValue(new BigDecimal("948205817.472950487"));
add(bigDecimalField);
```

## <a id="best-practices"></a>Best Practices

Number Field should be used for actual number values, such as counts and measures — values that may be part of a calculation. Don’t 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 set the default number of passengers to 1.

`69FAE707-4778-4093-8FB9-8BAE22E9D7F6`
