Segmented control
Also known as: Toggle group, Segmented button
Preview
Resources
Properties
| Property | Values | Default |
|---|---|---|
Size Variant | Sm | Md | Lg | Md |
Selected Boolean | Default | Active | Default |
State Variant | Default | Hover | Focus | Disabled | Default |
Start item Boolean | true | false | true |
Label Text | string | Label |
End item Boolean | true | false | true |
When to use
When selected option instantly changes the view of content.
When switching between different display formats.
When user needs to switch between the options without leaving the page.
When user needs to navigate between content, use tabs instead.
When user needs to filter through the content, use chips instead.
If there are more than four segments, consider using tabs.
States
Segmented control (and all other forms and selection controls) express states. States indicate current condition of the component to someone interacting with it. Using states ensure clear user feedback, highlighting possible actions or barriers. We have included most common states:
| State | Context |
|---|---|
Default | Status of the component before the interaction. Also referred to as ‘resting’. |
Hover | When the user moves their cursor over the component, but is not taking the action. Slight visual change can indicate interactivity of the component. |
Focus | When user selects the component via keyboard navigation, but has not yet taken action on it. |
Disabled | A non-interactive state where the component appears faded or grayed out. It indicates that the action is unavailable at the moment. |
Length
Segmented controls are best used for selecting between 2 to 4 options. If you need add more options, consider using tab list instead.