Tab list

Also known as: Page navigation, segmented control

Preview

Resources

Properties

PropertyValuesDefault
Size VariantSm | MdMd
Selected VariantDefault | ActiveDefault
State VariantDefault | Hover | FocusDefault
Start item Booleantrue | falsefalse
Label TextstringLabel
End item Booleantrue | falsefalse

When to use

You need to switch between multiple content sections within the same page.
The content under each tab is related and should be easily comparable.
There are only two options, use a segmented control instead.
The content under each tab is independent and not meant for quick comparisons.

States

Tab list (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:

StateContext
DefaultStatus of the component before the interaction. Also referred to as ‘resting’.
HoverWhen the user moves their cursor over the component, but is not taking the action. Slight visual change can indicate interactivity of the component.
FocusWhen user selects the component via keyboard navigation, but has not yet taken action on it.
DisabledA non-interactive state where the component appears faded or grayed out. It indicates that the action is unavailable at the moment.