Segmented Button
A group of connected buttons for choosing one option from a small mutually exclusive set. Selected segment uses selected tokens.
Appearance
Value
State
Accessibility
Props — SegmentedButton
View MUI docs| Prop | Type | Description |
|---|---|---|
size | "large" | "medium" | "small" | "extraSmall" | Segment height. Default medium (40). |
value | string | Controlled selected segment value. |
defaultValue | string | Initial selected value (uncontrolled). |
onChange | (value: string) => void | Called when the selected segment changes. |
options | SegmentedButtonOption[] | Segment labels, icons, values, and optional per-segment tooltip (iconOnly). |
iconOnly | boolean | Square icon-only segments. |
disabled | boolean | Disables the entire group. |
aria-label | string | Accessible name for the segment group. |