FormLabel API
Demos
For examples and details on the usage of this React component, visit the component demo pages:
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 both default and custom theme colors, which can be added as shown in the palette customization guide. | |
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 | 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. |
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
styleOverrides
property in a custom theme.