Content switcher
The following page documents visual specifications such as color, typography, structure, and size.
Color
Content switcher includes two default-enabled content states:Â selected and unselected with the selected state using a high contrast color.
Type | Element | Property | Color token |
---|---|---|---|
Selected | Container | background-color |
|
Label text | text-color |
| |
Icon | svg |
| |
Unselected | Container | background-color | transparent |
Label text | text-color |
| |
Icon | svg |
| |
Border | border |
| |
Divider | border |
|
* Denotes a contextual color token that will change values based on the layer it is placed on.
![Example of default content switcher enabled state](/static/44886a6f0e81d5231b39f3eab7015968/3cbba/content-switcher-style-color-enabled-text.png)
![Example of icon content switcher enabled state](/static/ccc8adf919dc82ba433123901028f011/3cbba/content-switcher-style-color-enabled-icon.png)
Interactive states
Content switcher has three interactive states—hover, focus, and disabled. Hover states only apply to the unselected state.
Type | State | Element | Property | Color token |
---|---|---|---|---|
Selected | Focus | Container | background-color |
|
Label text | text-color |
| ||
Icon | svg |
| ||
Border | inner-border |
| ||
Disabled | Container | background-color |
| |
Label text | text-color |
| ||
Icon | text-color |
| ||
Unselected | Hover | Container | background-color |
|
Label text | text-color |
| ||
Icon | svg |
| ||
Border | border |
| ||
Focus | Container | background-color | transparent | |
Label text | text-color |
| ||
Icon | svg |
| ||
Border | border |
| ||
Disabled | Container | background-color | transparent | |
Label text | text-color |
| ||
Icon | text-color |
| ||
Border | border |
| ||
Divider | border |
|
* Denotes a contextual color token that will change values based on the layer it is placed on.
![Example of default content switcher interactive states](/static/ec723e5f7e373271bf91a0fffc65bcd5/3cbba/content-switcher-style-color-text.png)
![Example of icon content switcher interactive states](/static/1fe85508f4ed88c00fa19e846af696c9/3cbba/content-switcher-style-color-icon.png)
Typography
Content switcher label text should be set in sentence case, with only the first word in a phrase and any proper nouns capitalized. The label text should not exceed three words.
Element | Font size (px/rem) | Font weight | Type token |
---|---|---|---|
Label text | 14 / 0.875 | Regular / 400 |
|
Structure
Content switchers must have at least two options for the user to choose from. Each container that makes up the content switcher is equal in size.
Element | Property | px / rem | Spacing token |
---|---|---|---|
Container | corner radius | 4px | – |
Label text | padding-left, padding-right | 16 / 1 |
|
Icon (sm) | padding-left, padding-right | 8 / 0.5 |
|
Icon (md) | padding-left, padding-right | 12 / 0.75 |
|
Icon (lg) | padding-left, padding-right | 14 / 0.875 | – |
Divider | border | 1px | – |
Default structure
The width of a text container is determined by the length of the longest label text within its content switcher.
![Text content switcher structure and spacing measurements](/static/27ac8400b1194b20da48525ae1641e51/3cbba/content-switcher-style-structure-text.png)
Structure and spacing measurements for the text content switcher | px / rem
Icon-only structure
The width of an icon container is determined by the fixed size within its content switcher.
![Icon content switcher structure and spacing measurements](/static/306c968c30379b34c04375df848f4595/3cbba/content-switcher-style-structure-icon.png)
Structure and spacing measurements for the icon content switcher | px / rem
Size
There are three content switcher sizes—small (32px), medium (40px), and large (48px).
Element | Size | Height (px / rem) |
---|---|---|
Container | Small (sm) | 32 / 2 |
Medium (md) | 40 / 2.5 | |
Large (lg) | 48 / 3 | |
Icon | Small (sm) | 16 / 1 |
Medium (md) | 16 / 1 | |
Large (lg) | 20 / 1.25 |
![Text only content switcher sizes | px / rem](/static/623f977238688eae590bdc7a4596cdfa/3cbba/content-switcher-style-size-text.png)
Text only content switcher sizes | px / rem
![Icon content switcher sizes | px / rem](/static/8cd72857ffaf34b3f3db8b8e0312aecd/3cbba/content-switcher-style-size-icon.png)
Icon only content switcher sizes | px / rem
Feedback
Help us improve this component by providing feedback, asking questions, and leaving any other comments on GitHub.