--- title: NumericTextBoxProps description: "Learn how to build custom functionality when working with the React Inputs by Kendo UI with the help of the NumericTextBoxProps." api_reference: true type: inner_api slug: api_inputs_numerictextboxprops --- # NumericTextBoxProps Represents the props of the [KendoReact NumericTextBox component](https://www.telerik.com/kendo-react-ui/components/inputs/numerictextbox).
| Name | Type | Default | Description |
|---|---|---|---|
| #### accessKey? |
string
|
Specifies the `accessKey` of the NumericTextBox. | |
| #### ariaDescribedBy? |
string
|
Identifies the element(s) which will describe the component, similar to [HTML aria-describedby attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute). For example these elements could contain error or hint message. | |
| #### ariaLabel? |
string
|
The accessible label of the component. | |
| #### ariaLabelledBy? |
string
|
Identifies the element(s) which will label the component. | |
| #### autoFocus? |
boolean
|
Represents the `autoFocus` HTML attribute that will be applied to the input element of the NumericTextBox. (Defaults to `false`) | |
| #### className? |
string
|
Sets a class of the NumericTextBox DOM element. | |
| #### defaultValue? |
"null" | number
|
Specifies the initial value. Leaves the subsequent updates uncontrolled. | |
| #### dir? |
string
|
Represents the `dir` HTML attribute. | |
| #### disabled? |
boolean
|
Determines whether the NumericTextBox is disabled. | |
| #### fillMode? |
"flat" | "solid" | "outline"
|
undefined (theme-controlled)
|
Configures the `fillMode` of the NumericTextBox.
The available options are:
- solid
- outline
- flat
```tsx
|
| #### format? |
string | NumberFormatOptions
|
Specifies the number format which is used for formatting the value ([see example](https://www.telerik.com/kendo-react-ui/components/inputs/numerictextbox/formats)). If set to `an empty string` or `undefined`, the default format will be used. Format cannot contain decimal separators or numbers. Power signs are supported. | |
| #### id? |
string
|
Sets the `id` of the `input` DOM element. | |
| #### inputAttributes? |
React.InputHTMLAttributes<HTMLInputElement>
|
Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed. | |
| #### inputStyle? |
React.CSSProperties
|
Represents the input element `style` HTML attribute. | |
| #### inputType? |
NumericTextBoxInputType
|
Sets the `type` of the `input` DOM element. The available options are: - (Default) `tel` - `text` | |
| #### label? |
string
|
Renders a floating label for the NumericTextBox. | |
| #### max? |
number
|
Specifies the greatest value that can be entered. | |
| #### min? |
number
|
Specifies the smallest value that can be entered. | |
| #### name? |
string
|
Specifies the name of the `input` DOM element. | |
| #### onBlur? |
(event: [NumericTextBoxBlurEvent]({% slug api_inputs_numerictextboxblurevent %})) => void
|
The event handler that will be fired when NumericTextBox is blurred. | |
| #### onChange? |
(event: [NumericTextBoxChangeEvent]({% slug api_inputs_numerictextboxchangeevent %})) => void
|
Determines the event handler that will be fired when the user edits the value. | |
| #### onFocus? |
(event: [NumericTextBoxFocusEvent]({% slug api_inputs_numerictextboxfocusevent %})) => void
|
The event handler that will be fired when NumericTextBox is focused. | |
| #### placeholder? |
string
|
Specifies the input placeholder. | |
| #### prefix? |
CustomComponent<any>
|
Sets a custom prefix to the NumericTextBox component. | |
| #### rangeOnEnter? |
boolean
|
If enabled, the NumericTextBox will handle the `enter` key to range the current invalid value between `min` and `max` props. The available options are: - (Default) `true` - `false` Can be disabled when form submit is required on pressing the `enter` key. | |
| #### readOnly? |
boolean
|
Determines whether the NumericTextBox is in its read-only state. | |
| #### required? |
boolean
|
Specifies if `null` is a valid value for the component. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### rounded? |
"small" | "none" | "medium" | "large" | "full"
|
undefined (theme-controlled)
|
Configures the `roundness` of the NumericTextBox.
The available options are:
- small
- medium
- large
- full
```tsx
|
| #### size? |
"small" | "medium" | "large"
|
undefined (theme-controlled)
|
Configures the `size` of the NumericTextBox.
The available options are:
- small
- medium
- large
```tsx
|
| #### spinners? |
boolean
|
Specifies whether the **Up** and **Down** spin buttons will be rendered ([see example](https://www.telerik.com/kendo-react-ui/components/inputs/numerictextbox/spin-buttons)). | |
| #### step? |
number
|
Specifies the value that is used to increment or decrement the value of the NumericTextBox ([see example](https://www.telerik.com/kendo-react-ui/components/inputs/numerictextbox/incremental-step)). | |
| #### style? |
React.CSSProperties
|
Represents the `style` HTML attribute. | |
| #### suffix? |
CustomComponent<any>
|
Sets a custom suffix to the NumericTextBox component. | |
| #### tabIndex? |
number
|
Sets the `tabIndex` property of the NumericTextBox. | |
| #### title? |
string
|
Sets the title of the `input` element of the NumericTextBox. | |
| #### valid? |
boolean
|
Overrides the validity state of the component. If `valid` is set, the `required` property will be ignored. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### validationMessage? |
string
|
Controls the form error message of the component. If set to an empty string, no error will be thrown. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### validityStyles? |
boolean
|
If set to `false`, no visual representation of the invalid state of the component will be applied. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### value? |
"null" | number
|
Specifies the value of the NumericTextBox. | |
| #### webMcp? |
boolean | WebMcpProps
|
Enables Web MCP tool registration for this component. Requires a parent `WebMcpProvider` from `@progress/kendo-react-webmcp`. | |
| #### width? |
string | number
|
Specifies the width of the NumericTextBox. |