StepLabel API
API documentation for the React StepLabel component. Learn about the available props, and the CSS API.
Import
import StepLabel from '@material-ui/core/StepLabel';
// or
import { StepLabel } from '@material-ui/core';
Component name
The nameMuiStepLabel
can be used when providing default props or style overrides in the theme.Props
Name | Type | Default | Description |
---|---|---|---|
children | node | In most cases will simply be a string containing a title for the label. | |
classes | object | Override or extend the styles applied to the component. See CSS API below for more details. | |
error | bool | false | Mark the step as failed. |
icon | node | Override the default label of the step icon. | |
optional | node | The optional node to display. | |
StepIconComponent | elementType | The component to render in place of the StepIcon . | |
StepIconProps | object | Props applied to the StepIcon element. |
The
ref
is forwarded to the root element.Any other props supplied will be provided to the root element (native element).
CSS
Rule name | Global class | Description |
---|---|---|
root | .MuiStepLabel-root | Styles applied to the root element. |
horizontal | .MuiStepLabel-horizontal | Styles applied to the root element if orientation="horizontal" . |
vertical | .MuiStepLabel-vertical | Styles applied to the root element if orientation="vertical" . |
label | .MuiStepLabel-label | Styles applied to the `Typography` component which wraps `children`. |
active | .MuiStepLabel-active | Pseudo-class applied to the `Typography` component if active={true} . |
completed | .MuiStepLabel-completed | Pseudo-class applied to the `Typography` component if completed={true} . |
error | .Mui-error | Pseudo-class applied to the root element and `Typography` component if error={true} . |
disabled | .Mui-disabled | Pseudo-class applied to the root element and `Typography` component if disabled={true} . |
iconContainer | .MuiStepLabel-iconContainer | Styles applied to the `icon` container element. |
alternativeLabel | .MuiStepLabel-alternativeLabel | Pseudo-class applied to the root and icon container and `Typography` if alternativeLabel={true} . |
labelContainer | .MuiStepLabel-labelContainer | Styles applied to the container element which wraps `Typography` and `optional`. |
You can override the style of the component using one of these customization options:
- With a rule name of the
classes
object prop. - With a global class name.
- With a theme and an
styleOverrides
property.