InputLabel API
API documentation for the React InputLabel component. Learn about the available props and the CSS API.
Import
import InputLabel from '@mui/material/InputLabel';
// or
import { InputLabel } from '@mui/material';Component name
The nameMuiInputLabel can be used when providing default props or style overrides in the theme.Props
Props of the FormLabel component are also available.
| Name | Type | Default | Description |
|---|---|---|---|
| children | node | The content of the component. | |
| classes | object | Override or extend the styles applied to the component. See CSS API below for more details. | |
| color | 'error' | 'info' | 'primary' | 'secondary' | 'success' | 'warning' | string | The color of the component. It supports those theme colors that make sense for this component. | |
| disableAnimation | bool | false | If true, the transition animation is disabled. |
| disabled | bool | false | If true, the component is disabled. |
| error | bool | false | If true, the label is displayed in an error state. |
| focused | bool | false | If true, the input of this label is focused. |
| margin | 'dense' | If dense, will adjust vertical spacing. This is normally obtained via context from FormControl. | |
| required | bool | false | if true, the label will indicate that the input is required. |
| shrink | bool | false | If true, the label is shrunk. |
| sx | Array<func | object | bool> | func | object | The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details. | |
| variant | 'filled' | 'outlined' | 'standard' | The variant to use. |
The
ref is forwarded to the root element.Inheritance
While not explicitly documented above, the props of the FormLabel component are also available on InputLabel. You can take advantage of this to target nested components.CSS
| Rule name | Global class | Description |
|---|---|---|
| root | .MuiInputLabel-root | Styles applied to the root element. |
| focused | .Mui-focused | State class applied to the root element if focused={true}. |
| disabled | .Mui-disabled | State class applied to the root element if disabled={true}. |
| error | .Mui-error | State class applied to the root element if error={true}. |
| required | .Mui-required | State class applied to the root element if required={true}. |
| asterisk | .MuiInputLabel-asterisk | State class applied to the asterisk element. |
| formControl | .MuiInputLabel-formControl | Styles applied to the root element if the component is a descendant of FormControl. |
| sizeSmall | .MuiInputLabel-sizeSmall | Styles applied to the root element if size="small". |
| shrink | .MuiInputLabel-shrink | Styles applied to the input element if shrink={true}. |
| animated | .MuiInputLabel-animated | Styles applied to the input element unless disableAnimation={true}. |
| filled | .MuiInputLabel-filled | Styles applied to the root element if variant="filled". |
| outlined | .MuiInputLabel-outlined | Styles applied to the root element if variant="outlined". |
| standard | .MuiInputLabel-standard | Styles applied to the root element if variant="standard". |
You can override the style of the component using one of these customization options:
- With a global class name.
- With a rule name as part of the component's
styleOverridesproperty in a custom theme.