--- title: MaskedTextBoxProps description: "Learn how to build custom functionality when working with the React Inputs by Kendo UI with the help of the MaskedTextBoxProps." api_reference: true type: inner_api slug: api_inputs_maskedtextboxprops --- # MaskedTextBoxProps Represents the props of the [KendoReact MaskedTextBox component](https://www.telerik.com/kendo-react-ui/components/inputs/maskedtextbox).
| Name | Type | Default | Description |
|---|---|---|---|
| #### accessKey? |
string
|
Specifies the `accessKey` of the MaskedTextBox. | |
| #### 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
|
Sets the accessible label text 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 MaskedTextBox. (Defaults to `false`) | |
| #### className? |
string
|
Sets a class of the MaskedTextBox DOM element.
```jsx
|
|
| #### defaultValue? |
string
|
Specifies the initial value. Leaves the subsequent updates uncontrolled. | |
| #### dir? |
string
|
Represents the `dir` HTML attribute.
```jsx
|
|
| #### disabled? |
boolean
|
Determines whether the MaskedTextBox is disabled.
```jsx
|
|
| #### fillMode? |
"flat" | "solid" | "outline"
|
undefined (theme-controlled)
|
Configures the `fillMode` of the MaskedTextBox.
The available options are:
- solid
- outline
- flat
```tsx
|
| #### id? |
string
|
Sets the `id` of the `input` DOM element. | |
| #### includeLiterals? |
boolean
|
Indicates whether to include literals in the raw value. Defaults to `false`. | |
| #### 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. | |
| #### label? |
React.ReactNode
|
Renders a floating label for the MaskedTextBox. | |
| #### mask? |
string
|
Represents the current mask. If no mask is set, the component behaves as a standard `type="text"` input.
```jsx
|
|
| #### maskValidation? |
boolean
|
Determines whether the built-in mask validator is enforced when a form is validated. Defaults to `true`. | |
| #### name? |
string
|
Specifies the `name` property of the `input` DOM element. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### onBlur? |
(event: [MaskedTextBoxEvent]({% slug api_inputs_maskedtextboxevent %})) => void
|
Fires each time the MaskedTextBox gets blurred. | |
| #### onChange? |
(event: [MaskedTextBoxChangeEvent]({% slug api_inputs_maskedtextboxchangeevent %})) => void
|
Determines the event handler that will be fired when the user edits the value.
```jsx
|
|
| #### onFocus? |
(event: [MaskedTextBoxEvent]({% slug api_inputs_maskedtextboxevent %})) => void
|
Fires each time the user focuses the MaskedTextBox. | |
| #### placeholder? |
string
|
Specifies the input placeholder.
```jsx
|
|
| #### prefix? |
CustomComponent<any>
|
Sets a custom prefix to the MaskedTextBox component. | |
| #### prompt? |
string
|
Represents a prompt character for the masked value. Defaults to `_`. | |
| #### promptPlaceholder? |
string
|
Indicates a character which represents an empty position in the raw value. Defaults to ` `. | |
| #### readonly? |
boolean
|
Determines whether the MaskedTextBox 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 MaskedTextBox.
The available options are:
- small
- medium
- large
- full
```tsx
|
| #### rules? |
{[key: string]: RegExp}
|
Represents the RegExp-based mask validation array. | |
| #### selection? |
{ end: number; start: number; }
|
Represents the beginning and ending of the selected portion of the input content that will be applied the next time when the MaskedTextBox is rendered. | |
| #### size? |
"small" | "medium" | "large"
|
undefined (theme-controlled)
|
Configures the `size` of the MaskedTextBox.
The available options are:
- small
- medium
- large
```tsx
|
| #### style? |
React.CSSProperties
|
Sets additional CSS styles to the MaskedTextBox DOM element.
```jsx
|
|
| #### suffix? |
CustomComponent<any>
|
Sets a custom suffix to the MaskedTextBox component. | |
| #### tabIndex? |
number
|
Sets the `tabIndex` property of the MaskedTextBox. | |
| #### title? |
string
|
Sets the title of the `input` element of the MaskedTextBox. | |
| #### 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? |
string
|
Specifies the value of the MaskedTextBox.
```jsx
|
|
| #### 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 MaskedTextBox.
```jsx
|