Skip to content

FormControl API

API reference docs for the React FormControl component. Learn about the props, CSS, and other APIs of this exported module.

Demos

For examples and details on the usage of this React component, visit the component demo pages:

Import

import FormControl from '@mui/material/FormControl';
// or
import { FormControl } from '@mui/material';
Learn about the difference by reading this guide on minimizing bundle size.

Provides context such as filled/focused/error/required for form inputs. Relying on the context provides high flexibility and ensures that the state always stays consistent across the children of the FormControl. This context is used by the following components:

  • FormLabel
  • FormHelperText
  • Input
  • InputLabel

You can find one composition example below and more going to the demos.

<FormControl>
  <InputLabel htmlFor="my-input">Email address</InputLabel>
  <Input id="my-input" aria-describedby="my-helper-text" />
  <FormHelperText id="my-helper-text">We'll never share your email.</FormHelperText>
</FormControl>

⚠️ Only one InputBase can be used within a FormControl because it creates visual inconsistencies. For instance, only one input can be focused at the same time, the state shouldn't be shared.

Props

Props of the native component are also available.

children
classes
color
component
disabled
error
focused
fullWidth
hiddenLabel
margin
required
size
sx
variant
The ref is forwarded to the root element.

Theme default props

You can use MuiFormControl to change the default props of this component with the theme.

CSS

The following class names are useful for styling with CSS (the state classes are marked).
To learn more, visit the component customization page.

.MuiFormControl-root
.MuiFormControl-marginNormal
.MuiFormControl-marginDense
.MuiFormControl-fullWidth

You can override the style of the component using one of these customization options: