FormLabel API
API documentation for the React FormLabel component. Learn about the available props and the CSS API.
Import
import FormLabel from '@mui/material/FormLabel';
// or
import { FormLabel } from '@mui/material';Component name
The nameMuiFormLabel can be used when providing default props or style overrides in the theme.Props
Props of the native 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. | |
| component | elementType | The component used for the root node. Either a string to use a HTML element or a component. | |
| disabled | bool | false | If true, the label should be displayed in a disabled state. |
| error | bool | false | If true, the label is displayed in an error state. |
| filled | bool | false | If true, the label should use filled classes key. |
| focused | bool | false | If true, the input of this label is focused (used by FormGroup components). |
| required | bool | false | If true, the label will indicate that the input is required. |
| sx | func | object | The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details. |
The
ref is forwarded to the root element.CSS
| Rule name | Global class | Description |
|---|---|---|
| root | .MuiFormLabel-root | Styles applied to the root element. |
| colorSecondary | .MuiFormLabel-colorSecondary | Styles applied to the root element if the color is secondary. |
| 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}. |
| filled | .MuiFormLabel-filled | State class applied to the root element if filled={true}. |
| required | .Mui-required | State class applied to the root element if required={true}. |
| asterisk | .MuiFormLabel-asterisk | Styles applied to the asterisk element. |
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.