Design Tokens
Categories
Design tokens are the visual design atoms of the design system — specifically, they are named entities that store visual design attributes. We use them in place of hard-coded values (such as hex values for color or pixel values for spacing) in order to maintain a scalable and consistent visual system for UI development.
Using Lightning Components? Read the Developer Guide on Styling with Design Tokens.
Token Support Legend:
Available to use on the Salesforce Platform.
Available to internal Salesforce developers only. Subject to change.
ColorsColors
Generic colors to use within a Salesforce application. Tokens that have the prefix of "BRAND" are brandable tokens and are subject to change when a customer applies theming to their org. Please refer to the description of each token for their intended usage.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$brand-accessibleDark variant of BRAND that is accessible with white | rgb(0, 112, 210) #0070d2 BRAND_ACCESSIBLE | 2.6.0 | Yes | GA |
$brand-accessible-activeActive / Hover state of BRAND_A11Y | rgb(0, 95, 178) #005fb2 BRAND_ACCESSIBLE_ACTIVE | 2.6.0 | Yes | GA |
$brand-background-darkDark variant of BRAND_BACKGROUND_PRIMARY, used within gradient of background color | rgb(25, 85, 148) #195594 BRAND_BACKGROUND_DARK | 2.6.0 | Yes | GA |
$brand-background-dark-transparentThese RGBA values need to be updated if BRAND_BACKGROUND_DARK changes, solves webkit bug | rgba(25, 85, 148, 0) rgba(25,85,148,0) | 2.6.0 | Yes | I |
$brand-background-primaryPrimary page background color | rgb(176, 196, 223) #b0c4df BRAND_BACKGROUND_PRIMARY | 2.6.0 | Yes | GA |
$brand-background-primary-transparentThese RGBA values need to be updated if BRAND_BACKGROUND_PRIMARY changes, solves webkit bug | rgba(176, 196, 223, 0) rgba(176,196,223,0) | 2.6.0 | Yes | I |
$brand-contrastVariant of BRAND that is accessible with BRAND | rgb(26, 27, 30) #1a1b1e BRAND_CONTRAST | 2.6.0 | Yes | GA |
$brand-contrast-activeActive / Hover state of BRAND_CONTRAST | rgb(13, 14, 18) #0d0e12 BRAND_CONTRAST_ACTIVE | 2.6.0 | Yes | GA |
$brand-darkDark variant of BRAND that is accessible with light colors | rgb(24, 35, 55) #182337 BRAND_DARK | 2.6.0 | Yes | GA |
$brand-dark-activeActive / Hover state of BRAND_DARK | rgb(37, 48, 69) #253045 BRAND_DARK_ACTIVE | 2.6.0 | Yes | GA |
$brand-disabledDisabled state of BRAND_A11Y | rgb(201, 199, 197) #c9c7c5 BRAND_DISABLED | 2.6.0 | Yes | GA |
$brand-headerBackground color a branded app header | rgb(255, 255, 255) #ffffff PALETTE_GRAY_1 | 2.6.0 | Yes | I |
$brand-header-contrastVariant of BRAND_HEADER that is accessible with BRAND_HEADER | rgb(94, 94, 94) #5e5e5e | 2.6.0 | Yes | I |
$brand-header-contrast-activeActive / Hover state of BRAND_HEADER_CONTRAST | rgb(80, 80, 80) #505050 | 2.6.0 | Yes | I |
$brand-header-contrast-coolVariant of BRAND_HEADER_CONTRAST that provides a cool color | rgb(0, 85, 131) #005583 | 2.6.0 | Yes | I |
$brand-header-contrast-cool-activeActive / Hover state of BRAND_HEADER_CONTRAST_COOL | rgb(0, 85, 131) #005583 | 2.6.0 | Yes | I |
$brand-header-contrast-inverseVariant of BRAND_HEADER that is accessible with BRAND_HEADER | rgb(255, 255, 255) #ffffff | 2.6.0 | Yes | I |
$brand-header-contrast-inverse-activeActive / Hover state of BRAND_HEADER_CONTRAST | rgb(238, 238, 238) #eeeeee | 2.6.0 | Yes | I |
$brand-header-contrast-warmVariant of BRAND_HEADER_CONTRAST that provides a warm color | rgb(191, 2, 1) #bf0201 | 2.6.0 | Yes | I |
$brand-header-contrast-warm-activeActive / Hover state of BRAND_HEADER_CONTRAST_WARM | rgb(172, 0, 0) #ac0000 | 2.6.0 | Yes | I |
$brand-header-contrast-weakWeak contrast ratio, useful for iconography | rgb(145, 145, 145) #919191 | 2.6.0 | Yes | I |
$brand-header-contrast-weak-activeActive / Hover state of BRAND_HEADER_CONTRAST_WEAK | rgb(129, 129, 129) #818181 | 2.6.0 | Yes | I |
$brand-header-contrast-weak-disabledDisabled state of BRAND_HEADER_CONTRAST_WEAK | rgba(166, 166, 166, 0.25) rgba(166,166,166,0.25) | 2.6.0 | Yes | I |
$brand-header-iconIcons of BRAND_HEADER that is accessible with BRAND_HEADER | rgb(145, 145, 145) #919191 | 2.6.0 | Yes | I |
$brand-header-icon-activeActive / Hover state of BRAND_HEADER_ICON | rgb(129, 129, 129) #818181 | 2.6.0 | Yes | I |
$brand-header-icon-disabledDisabled state of BRAND_HEADER_ICON | rgba(145, 145, 145, 0.25) rgba(145,145,145,0.25) | 2.6.0 | Yes | I |
$brand-lightLight variant of BRAND that is accessible with dark colors | rgb(244, 246, 254) #f4f6fe BRAND_LIGHT | 2.6.0 | Yes | GA |
$brand-light-activeActive / Hover state of BRAND_LIGHT | rgb(227, 229, 237) #e3e5ed BRAND_LIGHT_ACTIVE | 2.6.0 | Yes | GA |
$brand-primaryPrimary brand color | rgb(21, 137, 238) #1589ee BRAND_PRIMARY | 2.6.0 | Yes | GA |
$brand-primary-activeActive / Hover state of BRAND_PRIMARY | rgb(0, 122, 221) #007add BRAND_PRIMARY_ACTIVE | 2.6.0 | Yes | GA |
$brand-primary-transparentTransparent value of BRAND_PRIMARY | rgba(21, 137, 238, 0.1) rgba(21,137,238,0.1) | 2.6.0 | Yes | GA |
$brand-primary-transparent-10Transparent value of BRAND_PRIMARY at 10% | rgba(21, 137, 238, 0.1) rgba(21,137,238,0.1) | 2.6.0 | Yes | I |
$brand-primary-transparent-40Transparent value of BRAND_PRIMARY at 40% | rgba(21, 137, 238, 0.4) rgba(21,137,238,0.4) | 2.6.0 | Yes | I |
$brand-text-linkPrimary text link brand color | rgb(0, 109, 204) #006dcc BRAND_TEXT_LINK | 2.6.0 | Yes | GA |
$brand-text-link-activeActive / Hover state of BRAND_TEXT_LINK | rgb(0, 95, 178) #005fb2 BRAND_TEXT_LINK_ACTIVE | 2.6.0 | Yes | GA |
$color-gray-1Gray Color 1 | rgb(255, 255, 255) #ffffff PALETTE_GRAY_1 | 2.5.0 | No | I |
$color-gray-2Gray Color 2 | rgb(250, 250, 249) #fafaf9 PALETTE_GRAY_2 | 2.5.0 | No | I |
$color-gray-3Gray Color 3 | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 2.5.0 | No | I |
$color-gray-4Gray Color 4 | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 2.5.0 | No | I |
$color-gray-5Gray Color 5 | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 2.5.0 | No | I |
$color-gray-6Gray Color 6 | rgb(201, 199, 197) #c9c7c5 PALETTE_GRAY_6 | 2.5.0 | No | I |
$color-gray-7Gray Color 7 | rgb(176, 173, 171) #b0adab PALETTE_GRAY_7 | 2.5.0 | No | I |
$color-gray-8Gray Color 8 | rgb(150, 148, 146) #969492 PALETTE_GRAY_8 | 2.5.0 | No | I |
$color-gray-9Gray Color 9 | rgb(112, 110, 107) #706e6b PALETTE_GRAY_9 | 2.5.0 | No | I |
$color-gray-10Gray Color 10 | rgb(81, 79, 77) #514f4d PALETTE_GRAY_10 | 2.5.0 | No | I |
$color-gray-11Gray Color 11 | rgb(62, 62, 60) #3e3e3c PALETTE_GRAY_11 | 2.5.0 | No | I |
$color-gray-12Gray Color 12 | rgb(43, 40, 38) #2b2826 PALETTE_GRAY_12 | 2.5.0 | No | I |
$color-gray-13Gray Color 13 | rgb(8, 7, 7) #080707 PALETTE_GRAY_13 | 2.5.0 | No | I |
Background ColorBackground Color
Use these tokens for background colors only. Do not use these for border colors or text colors.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$color-backgroundDefault background color for the whole app. | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | GA |
$color-background-altSecond default background color for the app. | rgb(255, 255, 255) #ffffff WHITE | 1.0.0 | No | GA |
$color-background-alt-inverseAlternative background color for dark portions of the app. | rgb(22, 50, 92) #16325c BISCAY | 1.0.0 | No | GA |
$color-background-backdropThe color of the mask overlay that appears when you enter a modal state. | rgba(255, 255, 255, 0.75) WHITE_TRANSPARENT_75 | 1.0.0 | No | I |
$color-background-backdrop-tintThe color of the mask overlay that provides user feedback on interaction. | rgb(250, 250, 249) #fafaf9 PALETTE_GRAY_2 | 1.0.0 | No | I |
$color-background-customerBackground color for UI elements related to the concept of an external user or customer. | rgb(255, 154, 60) #ff9a3c TANGERINE | 1.0.0 | No | I |
$color-background-darkDark variant of COLOR_BACKGROUND. | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 2.8.0 | No | I |
$color-background-destructiveColor for UI elements related to destructive actions. | rgb(194, 57, 52) #c23934 FLUSH_MAHOGANY | 1.0.0 | No | I |
$color-background-destructive-activeActive color for UI elements related to destructive actions. | rgb(135, 5, 0) #870500 MAROON | 1.0.0 | No | I |
$color-background-destructive-hoverHover color for UI elements related to destructive actions. | rgb(166, 26, 20) #a61a14 TABASCO | 1.0.0 | No | I |
$color-background-errorColor for UI elements related to errors. | rgb(212, 80, 76) #d4504c VALENCIA | 1.0.0 | No | I |
$color-background-error-darkDark color for UI elements related to errors. Accessible with white text. | rgb(194, 57, 52) #c23934 FLUSH_MAHOGANY | 1.0.0 | No | I |
$color-background-highlightBackground color for highlighting UI elements. | rgb(250, 255, 189) #faffbd LEMON_CHIFFON | 1.0.0 | No | GA |
$color-background-highlight-searchBackground color for highlighting text in search results. | rgb(255, 240, 63) #fff03f GORSE | 1.0.0 | No | I |
$color-background-image-overlayColor of mask overlay that sits on top of an image when text is present. | rgba(0, 0, 0, 0.6) BLACK_TRANSPARENT_60 | 1.0.0 | No | I |
$color-background-infoBackground color for UI elements related to providing neutral information (not error, success, or warning). | rgb(112, 110, 107) #706e6b PALETTE_GRAY_9 | 1.0.0 | No | I |
$color-background-input-checkbox-disabledDisabled checkboxes | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$color-background-input-disabledDisabled input | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-background-inverseDefault background color for dark portions of the app (like Stage Left or tooltips). | rgb(6, 28, 63) #061c3f DEEP_COVE | 1.0.0 | No | GA |
$color-background-inverse-lightLight variant of COLOR_BACKGROUND_INVERSE. | rgb(22, 50, 92) #16325c BISCAY | 2.8.0 | No | I |
$color-background-lightLight variant of COLOR_BACKGROUND. | rgb(255, 255, 255) #ffffff PALETTE_GRAY_1 | 2.8.0 | No | I |
$color-background-notification-newBackground color for a new notification list item. | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | I |
$color-background-offlineColor for UI elements related to the offline state. | rgb(62, 62, 60) #3e3e3c PALETTE_GRAY_11 | 1.0.0 | No | I |
$color-background-postBackground color of comment posts in the feed. | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | I |
$color-background-row-activeUsed as the background color for the active state on rows or items on list-like components. | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-background-row-hoverUsed as the background color for the hover state on rows or items on list-like components. | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | I |
$color-background-row-newUsed as the background color for the new state on rows or items on list-like components. | rgb(217, 255, 223) #d9ffdf SNOWY_MINT | 1.0.0 | No | GA |
$color-background-row-selectedUsed as the background color for selected rows or items on list-like components. | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-background-scrollbarThe background color of an internal scrollbar. | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-background-scrollbar-trackThe background color of an internal scrollbar track. | rgb(201, 199, 197) #c9c7c5 PALETTE_GRAY_6 | 1.0.0 | No | I |
$color-background-selectionBackground color for text selected with a mouse. | rgb(216, 237, 255) #d8edff PATTEN_BLUE | 1.0.0 | No | I |
$color-background-spinner-dotColor of the spinner dot. | rgb(176, 173, 171) #b0adab PALETTE_GRAY_7 | 1.0.0 | No | I |
$color-background-stencilUsed as background for loading stencils on white background. | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | I |
$color-background-stencil-altUsed as an alternate background for loading stencils on gray backgrounds. | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-background-successColor for UI elements that have to do with success. | rgb(75, 202, 129) #4bca81 EMERALD | 1.0.0 | No | I |
$color-background-success-darkDark color for UI elements that have to do with success. Accessible with white text. | rgb(4, 132, 75) #04844b SALEM | 1.0.0 | No | I |
$color-background-success-darkerDarker color for UI elements that have to do with success. Accessible with white text. | rgb(0, 74, 41) #004a29 KAITOKE_GREEN | 1.0.0 | No | I |
$color-background-toastBackground color for toast messaging. | rgb(112, 110, 107) #706e6b PALETTE_GRAY_9 | 1.0.0 | No | I |
$color-background-toggleToggle background color. | rgb(176, 173, 171) #b0adab PALETTE_GRAY_7 | 1.0.0 | No | I |
$color-background-toggle-disabledDisabled toggle background color. | rgb(176, 173, 171) #b0adab PALETTE_GRAY_7 | 1.0.0 | No | I |
$color-background-toggle-hoverHovered toggle background color. | rgb(150, 148, 146) #969492 PALETTE_GRAY_8 | 1.0.0 | No | I |
$color-background-warningColor for UI elements that have to do with warning. | rgb(255, 183, 93) #ffb75d KOROMIKO | 1.0.0 | No | I |
$color-background-warning-darkDark Color for UI elements that have to do with warning. | rgb(255, 158, 44) #ff9e2c SUNSHADE | 1.0.0 | No | I |
$color-brandOur product brand blue. | rgb(21, 137, 238) #1589ee BRAND_PRIMARY | 1.0.0 | No | GA |
$color-brand-darkOur product brand blue, darkened to meet accessibility color contrast ratios with white text. | rgb(0, 112, 210) #0070d2 BRAND_ACCESSIBLE | 1.0.0 | No | GA |
$color-brand-darkerOur product brand blue, darkened even further. | rgb(0, 95, 178) #005fb2 ENDEAVOUR | 1.0.0 | No | I |
$color-picker-slider-thumb-color-background | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | I |
$page-header-color-backgroundDefault Page Header background color | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | I |
$popover-walkthrough-alt-image | /assets/images/popovers/popover-action.png | 1.0.0 | No | I |
$popover-walkthrough-alt-nubbin-color-background | rgb(33, 92, 160) #215ca0 | 1.0.0 | No | I |
$popover-walkthrough-color-background | rgb(3, 46, 97) #032e61 | 1.0.0 | No | I |
$popover-walkthrough-color-background-alt | rgb(22, 74, 133) #164a85 | 1.0.0 | No | I |
$popover-walkthrough-header-color-background | rgb(22, 74, 133) #164a85 | 1.0.0 | No | I |
$popover-walkthrough-header-image | /assets/images/popovers/popover-header.png | 1.0.0 | No | I |
$progress-color-background-shade | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | I |
$progress-color-border-shade | rgb(243, 242, 242) #f3f2f2 PALETTE_GRAY_3 | 1.0.0 | No | I |
$table-color-background-header | rgb(250, 250, 249) #fafaf9 PALETTE_GRAY_2 | 1.0.0 | No | I |
$table-color-background-header-hover | rgb(255, 255, 255) #ffffff PALETTE_GRAY_1 | 1.0.0 | No | I |
Text ColorText Color
Use these tokens for text colors only. Do not use these for border colors or background colors.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$color-text-action-labelAction label text color | Aa rgb(62, 62, 60) #3e3e3c PALETTE_GRAY_11 | 1.0.0 | No | GA |
$color-text-action-label-activeAction label active text color | Aa rgb(8, 7, 7) #080707 PALETTE_GRAY_13 | 1.0.0 | No | GA |
$color-text-brandOur product brand blue. | Aa rgb(21, 137, 238) #1589ee BRAND_PRIMARY | 1.0.0 | No | GA |
$color-text-brand-primaryText color found on any primary brand color | Aa rgb(255, 255, 255) #ffffff WHITE | 1.0.0 | No | I |
$color-text-button-default-disabledText color for default secondary button - disabled state | Aa rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$color-text-button-default-hintText color for a button that has a parent element that has a hover state. This is the default text/icon color for that button before its parent has been hovered over. | Aa rgb(176, 173, 171) #b0adab PALETTE_GRAY_7 | 1.0.0 | No | I |
$color-text-button-inverseText color for a button that has a parent element that has a hover state. This is the default text/icon color for that button before its parent has been hovered over. | Aa rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-text-customerCustomer text used in anchor subtitle | Aa rgb(255, 154, 60) #ff9a3c TANGERINE | 1.0.0 | No | I |
$color-text-defaultBody text color | Aa rgb(8, 7, 7) #080707 PALETTE_GRAY_13 | 1.0.0 | No | GA |
$color-text-destructiveText color for destructive actions | Aa rgb(194, 57, 52) #c23934 FLUSH_MAHOGANY | 1.0.0 | No | I |
$color-text-destructive-hoverText color for destructive actions - hover state | Aa rgb(161, 43, 43) #a12b2b MEXICAN_RED | 1.0.0 | No | I |
$color-text-errorError text for inputs and error misc | Aa rgb(194, 57, 52) #c23934 FLUSH_MAHOGANY | 1.0.0 | No | GA |
$color-text-icon-defaultDefault icon color. | Aa rgb(112, 110, 107) #706e6b PALETTE_GRAY_9 | 1.0.0 | No | I |
$color-text-icon-default-disabledDefault icon color - disabled state | Aa rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$color-text-icon-default-hintIcon color for a button that has a parent element that has a hover state. This is the default text/icon color for that button before its parent has been hovered over. | Aa rgb(176, 173, 171) #b0adab PALETTE_GRAY_7 | 1.0.0 | No | I |
$color-text-icon-inverseIcon color on dark background | Aa rgb(255, 255, 255) #ffffff PALETTE_GRAY_1 | 1.0.0 | No | I |
$color-text-icon-inverse-activeIcon color on dark background - active state | Aa rgb(255, 255, 255) #ffffff PALETTE_GRAY_1 | 1.0.0 | No | I |
$color-text-icon-inverse-hoverIcon color on dark background - hover state | Aa rgb(255, 255, 255) #ffffff PALETTE_GRAY_1 | 1.0.0 | No | I |
$color-text-input-disabledInput disabled text | Aa rgb(62, 62, 60) #3e3e3c PALETTE_GRAY_11 | 1.0.0 | No | I |
$color-text-input-iconInput icon | Aa rgb(176, 173, 171) #b0adab PALETTE_GRAY_7 | 1.0.0 | No | I |
$color-text-inverseInverse text color for dark backgrounds | Aa rgb(255, 255, 255) #ffffff WHITE | 1.0.0 | No | GA |
$color-text-inverse-weakWeak inverse text color for dark backgrounds | Aa rgb(176, 173, 171) #b0adab PALETTE_GRAY_7 | 1.0.0 | No | GA |
$color-text-labelText color for field labels. | Aa rgb(62, 62, 60) #3e3e3c PALETTE_GRAY_11 | 1.0.0 | No | GA |
$color-text-linkLink text (508) | Aa rgb(0, 109, 204) #006dcc BRAND_TEXT_LINK | 1.0.0 | No | GA |
$color-text-link-activeActive link text | Aa rgb(0, 57, 107) #00396b MIDNIGHT_BLUE | 1.0.0 | No | GA |
$color-text-link-disabledDisabled link text | Aa rgb(22, 50, 92) #16325c BISCAY | 1.0.0 | No | GA |
$color-text-link-focusFocus link text | Aa rgb(0, 95, 178) #005fb2 ENDEAVOUR | 1.0.0 | No | GA |
$color-text-link-hoverHover link text | Aa rgb(0, 95, 178) #005fb2 BRAND_TEXT_LINK_ACTIVE | 1.0.0 | No | GA |
$color-text-link-inverseLink color on dark background | Aa rgb(255, 255, 255) #ffffff WHITE | 1.0.0 | No | GA |
$color-text-link-inverse-activeLink color on dark background - active state | Aa rgba(255, 255, 255, 0.5) WHITE_TRANSPARENT_50 | 1.0.0 | No | GA |
$color-text-link-inverse-disabledLink color on dark background - disabled state | Aa rgba(255, 255, 255, 0.15) WHITE_TRANSPARENT_15 | 1.0.0 | No | GA |
$color-text-link-inverse-hoverLink color on dark background - hover state | Aa rgba(255, 255, 255, 0.75) WHITE_TRANSPARENT_75 | 1.0.0 | No | GA |
$color-text-placeholderInput placeholder text. | Aa rgb(112, 110, 107) #706e6b PALETTE_GRAY_9 | 1.0.0 | No | GA |
$color-text-placeholder-inverseInput placeholder text on dark backgrounds. | Aa rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | GA |
$color-text-requiredColor of required field marker. | Aa rgb(194, 57, 52) #c23934 FLUSH_MAHOGANY | 1.0.0 | No | GA |
$color-text-successText color for success text. | Aa rgb(2, 126, 70) #027e46 FOREST_GREEN | 1.0.0 | No | I |
$color-text-success-inverseText color for success text on dark backgrounds. | Aa rgb(75, 202, 129) #4bca81 EMERALD | 1.0.0 | No | I |
$color-text-tab-labelColor for default text in a tab group. | Aa rgb(43, 40, 38) #2b2826 PALETTE_GRAY_12 | 1.0.0 | No | I |
$color-text-tab-label-disabledColor for disabled text in a tab group. | Aa rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-text-toggle-disabledColor for disabled toggles | Aa rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$color-text-warningColor for texts or icons that are related to warnings on a dark background. | Aa rgb(255, 183, 93) #ffb75d KOROMIKO | 1.0.0 | No | I |
$color-text-warning-altColor for texts that are related to warnings on a light background. | Aa rgb(132, 72, 0) #844800 CINNAMON | 1.0.0 | No | I |
$color-text-weakColor for text that is purposefully de-emphasized to create visual hierarchy. | Aa rgb(62, 62, 60) #3e3e3c PALETTE_GRAY_11 | 1.0.0 | No | GA |
Border ColorBorder Color
Use these tokens for border colors only. Do not use these for background colors or text colors.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$button-color-border-primary | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$card-color-border | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$card-footer-color-border | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$color-borderDefault border color for UI elements. | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | GA |
$color-border-brandOur product brand blue. | rgb(21, 137, 238) #1589ee BRAND_PRIMARY | 1.0.0 | No | GA |
$color-border-brand-darkOur product brand blue, darkened to meet accessibility color contrast ratios with white text. | rgb(0, 112, 210) #0070d2 BRAND_ACCESSIBLE | 1.0.0 | No | I |
$color-border-button-defaultBorder color for default secondary button | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$color-border-button-focus-inverse | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-border-customerBorder color for UI elements related to the concept of an external user or customer. | rgb(255, 154, 60) #ff9a3c TANGERINE | 1.0.0 | No | I |
$color-border-destructiveBorder color for UI elements that have to do with destructive actions. | rgb(194, 57, 52) #c23934 FLUSH_MAHOGANY | 1.0.0 | No | I |
$color-border-destructive-activeActive border color for UI elements that have to do with destructive actions. | rgb(135, 5, 0) #870500 MAROON | 1.0.0 | No | I |
$color-border-destructive-hoverHover border color for UI elements that have to do with destructive actions. | rgb(166, 26, 20) #a61a14 TABASCO | 1.0.0 | No | I |
$color-border-errorBorder color for UI elements that have to do with errors. | rgb(194, 57, 52) #c23934 FLUSH_MAHOGANY | 1.0.0 | No | GA |
$color-border-error-altAlternative border color for UI elements related to errors. | rgb(234, 130, 136) #ea8288 DEEP_BLUSH | 1.0.0 | No | I |
$color-border-error-darkDark alternative border color for UI elements related to errors. | rgb(234, 130, 136) #ea8288 DEEP_BLUSH | 1.0.0 | No | I |
$color-border-infoBorder color for UI elements related to providing neutral information (not error, success, or warning). | rgb(112, 110, 107) #706e6b PALETTE_GRAY_9 | 1.0.0 | No | I |
$color-border-inputBorder color on form elements. | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$color-border-input-disabledBorder color on disabled form elements. | rgb(201, 199, 197) #c9c7c5 PALETTE_GRAY_6 | 1.0.0 | No | I |
$color-border-inverseBorder color to match UI elements using color-background-inverse. | rgb(6, 28, 63) #061c3f DEEP_COVE | 1.0.0 | No | I |
$color-border-link-focus-inverse | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-border-offlineBorder color for UI elements related to the offline state. | rgb(62, 62, 60) #3e3e3c PALETTE_GRAY_11 | 1.0.0 | No | I |
$color-border-reminderBorder color on notification reminders. | rgb(236, 235, 234) #ecebea PALETTE_GRAY_4 | 1.0.0 | No | I |
$color-border-row-selectedUsed as the border color for selected rows or items on list-like components. | rgb(0, 112, 210) #0070d2 BRAND_ACCESSIBLE | 1.0.0 | No | GA |
$color-border-row-selected-hoverUsed as the border color for the hover state on selected rows or items on list-like components. | rgb(21, 137, 238) #1589ee BRAND_PRIMARY | 1.0.0 | No | GA |
$color-border-selectionUsed to delineate the boundary of a selected component. Specific to builders. | rgb(0, 112, 210) #0070d2 BRAND_ACCESSIBLE | 1.0.0 | No | I |
$color-border-selection-activeUsed to delineate the boundary of a component that is being clicked. Specific to builders. | rgb(250, 250, 249) #fafaf9 PALETTE_GRAY_2 | 1.0.0 | No | I |
$color-border-selection-hoverUsed to delineate the boundary of a component that is being hovered over. Specific to builders. | rgb(21, 137, 238) #1589ee BRAND_PRIMARY | 1.0.0 | No | I |
$color-border-separatorLightest separator color - used as default separator on white backgrounds. | rgb(250, 250, 249) #fafaf9 PALETTE_GRAY_2 | 1.0.0 | No | GA |
$color-border-separator-altMedium separator color - used as default separator on light gray backgrounds. | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | GA |
$color-border-separator-alt-2Darkest separator color - used as an alternate separator color when more differentiation is desired. | rgb(201, 199, 197) #c9c7c5 PALETTE_GRAY_6 | 1.0.0 | No | I |
$color-border-separator-inverseUsed as a separator on dark backgrounds, such as stage left navigation. | rgb(42, 66, 108) #2a426c SAN_JUAN | 1.0.0 | No | GA |
$color-border-successBorder color for UI elements that have to do with success. | rgb(75, 202, 129) #4bca81 EMERALD | 1.0.0 | No | GA |
$color-border-success-darkDark alternative border color for UI elements that have to do with success. | rgb(4, 132, 75) #04844b SALEM | 1.0.0 | No | I |
$color-border-warningBorder color for UI elements that have to do with warnings. | rgb(255, 183, 93) #ffb75d KOROMIKO | 1.0.0 | No | GA |
$page-header-color-border | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
$page-header-joined-color-border | rgb(221, 219, 218) #dddbda PALETTE_GRAY_5 | 1.0.0 | No | I |
FontFont
Use these font weights to change how thin or heavy the weight is for our font.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$card-font-weightUse for active tab. | Aa 700 FONT_WEIGHT_BOLD | 1.0.0 | No | I |
$font-familyDefault font-family for Salesforce applications | Aa 'Salesforce Sans', Arial, sans-serif SANS_SERIF | 1.0.0 | No | GA |
$font-family-heading | Aa 'Salesforce Sans', Arial, sans-serif SANS_SERIF | 1.0.0 | No | I |
$font-family-monospace | Aa Consolas, Menlo, Monaco, Courier, monospace MONOSPACE | 1.0.0 | No | I |
$font-weight-boldUsed sparingly for emphasized text within regular body copy. | Aa 700 FONT_WEIGHT_BOLD | 1.0.0 | No | GA |
$font-weight-lightUse for large headings only. | Aa 300 FONT_WEIGHT_LIGHT | 1.0.0 | No | GA |
$font-weight-regularMost all body copy. | Aa 400 FONT_WEIGHT_REGULAR | 1.0.0 | No | GA |
$form-label-font-size | Aa 0.75rem FONT_SIZE_2 12px | 1.0.0 | No | I |
$input-static-font-size | Aa 0.875rem FONT_SIZE_4 14px | 1.0.0 | No | I |
$input-static-font-weight | Aa 400 FONT_WEIGHT_REGULAR | 1.0.0 | No | I |
$page-header-title-font-weight | Aa 700 FONT_WEIGHT_BOLD | 1.0.0 | No | I |
$tabs-font-weightUse for active tab. | Aa 700 FONT_WEIGHT_BOLD | 1.0.0 | No | I |
Font SizeFont Size
Use these sizing tokens for font sizes.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$font-size-1Constant typography token for font size 1 | Aa 0.625rem FONT_SIZE_1 10px | 1.0.0 | No | I |
$font-size-2Constant typography token for font size 2 | Aa 0.75rem FONT_SIZE_2 12px | 1.0.0 | No | I |
$font-size-3Constant typography token for font size 3 | Aa 0.8125rem FONT_SIZE_3 13px | 1.0.0 | No | I |
$font-size-4Constant typography token for font size 4 | Aa 0.875rem FONT_SIZE_4 14px | 1.0.0 | No | I |
$font-size-5Constant typography token for font size 5 | Aa 1rem FONT_SIZE_5 16px | 1.0.0 | No | I |
$font-size-6Constant typography token for font size 6 | Aa 1.125rem FONT_SIZE_6 18px | 1.0.0 | No | I |
$font-size-7Constant typography token for font size 7 | Aa 1.25rem FONT_SIZE_7 20px | 1.0.0 | No | I |
$font-size-8Constant typography token for font size 8 | Aa 1.5rem FONT_SIZE_8 24px | 1.0.0 | No | I |
$font-size-9Constant typography token for font size 9 | Aa 1.75rem FONT_SIZE_9 28px | 1.0.0 | No | I |
$font-size-10Constant typography token for font size 10 | Aa 2rem FONT_SIZE_10 32px | 1.0.0 | No | I |
$font-size-11Constant typography token for font size 11 | Aa 2.625rem FONT_SIZE_11 42px | 1.0.0 | No | I |
$var-font-size-1Variable typography token for font size 1 | Aa 0.625rem FONT_SIZE_1 10px | 1.0.0 | No | I |
$var-font-size-2Variable typography token for font size 2 | Aa 0.75rem FONT_SIZE_2 12px | 1.0.0 | No | I |
$var-font-size-3Variable typography token for font size 3 | Aa 0.8125rem FONT_SIZE_3 13px | 1.0.0 | No | I |
$var-font-size-4Variable typography token for font size 4 | Aa 0.875rem FONT_SIZE_4 14px | 1.0.0 | No | I |
$var-font-size-5Variable typography token for font size 5 | Aa 1rem FONT_SIZE_5 16px | 1.0.0 | No | I |
$var-font-size-6Variable typography token for font size 6 | Aa 1.125rem FONT_SIZE_6 18px | 1.0.0 | No | I |
$var-font-size-7Variable typography token for font size 7 | Aa 1.25rem FONT_SIZE_7 20px | 1.0.0 | No | I |
$var-font-size-8Variable typography token for font size 8 | Aa 1.5rem FONT_SIZE_8 24px | 1.0.0 | No | I |
$var-font-size-9Variable typography token for font size 9 | Aa 1.75rem FONT_SIZE_9 28px | 1.0.0 | No | I |
$var-font-size-10Variable typography token for font size 10 | Aa 2rem FONT_SIZE_10 32px | 1.0.0 | No | I |
$var-font-size-11Variable typography token for font size 11 | Aa 2.625rem FONT_SIZE_11 42px | 1.0.0 | No | I |
OpacityOpacity
Use these opacity tokens for element transparency.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$opacity-550% transparency of an element | 0.5 | 1.0.0 | No | I |
$opacity-880% transparency of an element | 0.8 | 1.0.0 | No | I |
Line HeightLine Height
Use these tokens for changing the line-height of elements. Usually, the line-height-text is already inherited by default. Only set it if you need to apply it again.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$line-height-headingUnitless line-heights for reusability | The quick brown fox jumps over the lazy dog 1.25 | 1.0.0 | No | GA |
$line-height-resetRemove extra leading. Unitless line-heights for reusability | The quick brown fox jumps over the lazy dog 1 | 1.0.0 | No | GA |
$line-height-textUnitless line-heights for reusability | The quick brown fox jumps over the lazy dog 1.5 | 1.0.0 | No | GA |
$var-line-height-textVariable unitless line-heights for reusability | The quick brown fox jumps over the lazy dog 1.5 | 1.0.0 | No | I |
SpacingSpacing
Spacing tokens are used for padding, margins, and position coordinates. Border-width tokens are used for the border property.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$spacing-largeConstant spacing token for size Large | 1.5rem SPACING_LARGE 24px | 1.0.0 | No | GA |
$spacing-mediumConstant spacing token for size Medium | 1rem SPACING_MEDIUM 16px | 1.0.0 | No | GA |
$spacing-noneConstant spacing token for 0 | 0 SPACING_NONE | 1.0.0 | No | I |
$spacing-smallConstant spacing token for size Small | 0.75rem SPACING_SMALL 12px | 1.0.0 | No | GA |
$spacing-x-largeConstant spacing token for size X Large | 2rem SPACING_X_LARGE 32px | 1.0.0 | No | GA |
$spacing-x-smallConstant spacing token for size X small | 0.5rem SPACING_X_SMALL 8px | 1.0.0 | No | GA |
$spacing-xx-largeConstant spacing token for size XX Large | 3rem SPACING_XX_LARGE 48px | 1.0.0 | No | GA |
$spacing-xx-smallConstant spacing token for size XX small | 0.25rem SPACING_XX_SMALL 4px | 1.0.0 | No | GA |
$spacing-xxx-smallConstant spacing token for size XXX small | 0.125rem SPACING_XXX_SMALL 2px | 1.0.0 | No | GA |
$table-cell-spacing | 0.25rem 0.5rem SPACING_XX_SMALL SPACING_X_SMALL 4px 8px | 1.0.0 | No | I |
$template-gutters | 0.75rem SPACING_SMALL 12px | 1.0.0 | No | I |
$template-profile-gutters | 8rem 0.75rem 0.75rem 8rem SPACING_SMALL SPACING_SMALL 128px 12px 12px | 1.0.0 | No | I |
$var-spacing-horizontal-largeVariable horizontal spacing token for size Large | 1.5rem SPACING_LARGE 24px | 2.7.0 | No | GA |
$var-spacing-horizontal-mediumVariable horizontal spacing token for size Medium | 1rem SPACING_MEDIUM 16px | 2.7.0 | No | GA |
$var-spacing-horizontal-smallVariable horizontal spacing token for size Small | 0.75rem SPACING_SMALL 12px | 2.7.0 | No | GA |
$var-spacing-horizontal-x-largeVariable horizontal spacing token for size X Large | 2rem SPACING_X_LARGE 32px | 2.7.0 | No | GA |
$var-spacing-horizontal-x-smallVariable horizontal spacing token for size X Small | 0.5rem SPACING_X_SMALL 8px | 2.7.0 | No | GA |
$var-spacing-horizontal-xx-largeVariable horizontal spacing token for size XX Large | 3rem SPACING_XX_LARGE 48px | 2.7.0 | No | GA |
$var-spacing-horizontal-xx-smallVariable horizontal spacing token for size XX Small | 0.25rem SPACING_XX_SMALL 4px | 2.7.0 | No | GA |
$var-spacing-horizontal-xxx-smallVariable horizontal spacing token for size XXX Small | 0.125rem SPACING_XXX_SMALL 2px | 2.7.0 | No | GA |
$var-spacing-largeVariable spacing token for size Large | 1.5rem SPACING_LARGE 24px | 2.7.0 | No | GA |
$var-spacing-mediumVariable spacing token for size Medium | 1rem SPACING_MEDIUM 16px | 2.7.0 | No | GA |
$var-spacing-smallVariable spacing token for size Small | 0.75rem SPACING_SMALL 12px | 2.7.0 | No | GA |
$var-spacing-vertical-largeVariable vertical spacing token for size Large | 1.5rem SPACING_LARGE 24px | 2.7.0 | No | GA |
$var-spacing-vertical-mediumVariable vertical spacing token for size Medium | 1rem SPACING_MEDIUM 16px | 2.7.0 | No | GA |
$var-spacing-vertical-smallVariable vertical spacing token for size Small | 0.75rem SPACING_SMALL 12px | 2.7.0 | No | GA |
$var-spacing-vertical-x-largeVariable vertical spacing token for size X Large | 2rem SPACING_X_LARGE 32px | 2.7.0 | No | GA |
$var-spacing-vertical-x-smallVariable vertical spacing token for size X Small | 0.5rem SPACING_X_SMALL 8px | 2.7.0 | No | GA |
$var-spacing-vertical-xx-largeVariable vertical spacing token for size XX Large | 3rem SPACING_XX_LARGE 48px | 2.7.0 | No | GA |
$var-spacing-vertical-xx-smallVariable vertical spacing token for size XX Small | 0.25rem SPACING_XX_SMALL 4px | 2.7.0 | No | GA |
$var-spacing-vertical-xxx-smallVariable vertical spacing token for size XXX Small | 0.125rem SPACING_XXX_SMALL 2px | 2.7.0 | No | GA |
$var-spacing-x-largeVariable spacing token for size X Large | 2rem SPACING_X_LARGE 32px | 2.7.0 | No | GA |
$var-spacing-x-smallVariable spacing token for size X Small | 0.5rem SPACING_X_SMALL 8px | 2.7.0 | No | GA |
$var-spacing-xx-largeVariable spacing token for size XX Large | 3rem SPACING_XX_LARGE 48px | 2.7.0 | No | GA |
$var-spacing-xx-smallVariable spacing token for size XX Small | 0.25rem SPACING_XX_SMALL 4px | 2.7.0 | No | GA |
$var-spacing-xxx-smallVariable spacing token for size XXX Small | 0.125rem SPACING_XXX_SMALL 2px | 2.7.0 | No | GA |
RadiusRadius
Use radius tokens to change the border-radius size (rounded corners).
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$border-radius-circleCircle for global use, action icon bgd shape | 50% BORDER_RADIUS_CIRCLE | 1.0.0 | No | GA |
$border-radius-large | 0.5rem BORDER_RADIUS_LARGE 8px | 1.0.0 | No | GA |
$border-radius-mediumIcons in lists, record home icon, unbound input elements | 0.25rem BORDER_RADIUS_MEDIUM 4px | 1.0.0 | No | GA |
$border-radius-small | 0.125rem BORDER_RADIUS_SMALL 2px | 1.0.0 | No | GA |
$page-header-border-radius | 0.25rem BORDER_RADIUS_MEDIUM 4px | 1.0.0 | No | I |
$table-border-radius | 0 0 0.25rem 0.25rem 0 0 BORDER_RADIUS_MEDIUM BORDER_RADIUS_MEDIUM 0 0 4px 4px | 1.0.0 | No | I |
SizingSizing
Use sizing tokens to set elements to our sizing scale. Size tokens can be used for the width and height properties. Square tokens are used for both width and height.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$height-headerHeader for desktop. | 3.125rem 50px | 1.0.0 | No | GA |
$size-largeGeneric sizing token scale for UI components. | 25rem SIZE_LARGE 400px | 1.0.0 | No | GA |
$size-mediumGeneric sizing token scale for UI components. | 20rem SIZE_MEDIUM 320px | 1.0.0 | No | GA |
$size-smallGeneric sizing token scale for UI components. | 15rem SIZE_SMALL 240px | 1.0.0 | No | GA |
$size-x-largeGeneric sizing token scale for UI components. | 40rem SIZE_X_LARGE 640px | 1.0.0 | No | GA |
$size-x-smallGeneric sizing token scale for UI components. | 12rem SIZE_X_SMALL 192px | 1.0.0 | No | GA |
$size-xx-largeGeneric sizing token scale for UI components. | 60rem SIZE_XX_LARGE 960px | 1.0.0 | No | GA |
$size-xx-smallGeneric sizing token scale for UI components. | 6rem SIZE_XX_SMALL 96px | 1.0.0 | No | GA |
$size-xxx-smallGeneric sizing token scale for UI components. | 3rem SIZE_XXX_SMALL 48px | 1.0.0 | No | I |
$square-icon-large-boundaryAnchor: Outer colored tile | 3rem 48px | 1.0.0 | No | GA |
$square-icon-large-boundary-altAnchor: avatar | 5rem 80px | 1.0.0 | No | GA |
$square-icon-large-contentAnchor: Icon content (white shape) | 2rem SIZE_SQUARE_XX_LARGE 32px | 1.0.0 | No | GA |
$square-icon-mediumMedium tap target size | 2rem 32px | 1.0.0 | No | I |
$square-icon-medium-boundaryStage left & actions: Outer colored tile | 2rem SIZE_SQUARE_XX_LARGE 32px | 1.0.0 | No | GA |
$square-icon-medium-boundary-altIcon button boundary. | 2.25rem SIZE_SQUARE_XXX_LARGE 36px | 1.0.0 | No | GA |
$square-icon-medium-contentStage left & actions: Icon content (white shape) | 1rem SIZE_SQUARE_MEDIUM 16px | 1.0.0 | No | GA |
$square-icon-medium-content-altAlternate medium tap target size | 0.875rem SIZE_SQUARE_SMALL 14px | 1.0.0 | No | I |
$square-icon-small-boundarySearch Results: Outer colored tile | 1.5rem SIZE_SQUARE_X_LARGE 24px | 1.0.0 | No | GA |
$square-icon-small-contentSearch Results: Icon content (white shape) | 0.75rem SIZE_SQUARE_XX_SMALL 12px | 1.0.0 | No | GA |
$square-icon-utility-largeLarge utility icon without border. | 1.5rem SIZE_SQUARE_X_LARGE 24px | 1.0.0 | No | GA |
$square-icon-utility-mediumMedium utility icon without border. | 1.25rem SIZE_SQUARE_LARGE 20px | 1.0.0 | No | GA |
$square-icon-utility-smallSmall utility icon without border. | 1rem SIZE_SQUARE_MEDIUM 16px | 1.0.0 | No | GA |
$square-icon-x-small-boundaryVery small icon button boundary. | 1.25rem SIZE_SQUARE_LARGE 20px | 1.0.0 | No | GA |
$square-icon-x-small-contentVery small icons in icon buttons. | 0.5rem SIZE_SQUARE_XXX_SMALL 8px | 1.0.0 | No | GA |
$square-icon-xx-small-boundaryVery very small icon button boundary. | 1rem SIZE_SQUARE_MEDIUM 16px | 1.0.0 | No | I |
$var-square-icon-medium-boundaryVariable medium boundary for square icons | 2rem SIZE_SQUARE_XX_LARGE 32px | 1.0.0 | No | I |
ShadowShadow
Use shadow tokens to set a box shadow.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$card-shadowHard dropshadow found on outer cards | 0 2px 2px 0 rgba(0, 0, 0, 0.10) 0 2px 2px 0 BLACK_TRANSPARENT_10 | 1.0.0 | No | I |
$page-header-shadowHard dropshadow on page header | 0 2px 2px 0 rgba(0, 0, 0, 0.10) 0 2px 2px 0 BLACK_TRANSPARENT_10 | 1.0.0 | No | I |
$shadow-activeShadow for active states on interactive elements. | 0 0 2px #0070d2 OFFSET_NONE OFFSET_NONE OFFSET_X_SMALLpx BRAND_ACCESSIBLE | 1.0.0 | No | I |
$shadow-dragShadow for drag-n-drop. | 0 2px 4px 0 rgba(0, 0, 0, 0.40) OFFSET_NONE OFFSET_X_SMALLpx OFFSET_MEDIUMpx OFFSET_NONE BLACK_TRANSPARENT_40 | 1.0.0 | No | GA |
$shadow-drop-downShadow for drop down. | 0 2px 3px 0 rgba(0, 0, 0, 0.16) OFFSET_NONE OFFSET_X_SMALLpx OFFSET_SMALLpx OFFSET_NONE BLACK_TRANSPARENT_16 | 1.0.0 | No | GA |
TimeTime
Use timing tokens for animation durations.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$duration-immediately0.05 seconds, 3 frames | 0.05s DURATION_IMMEDIATELY | 1.0.0 | No | GA |
$duration-instantly0 seconds, 0 frames | 0s DURATION_INSTANTLY | 1.0.0 | No | GA |
$duration-paused3.2 seconds, 192 frames | 3.2s DURATION_PAUSED | 1.0.0 | No | GA |
$duration-promptly0.2 seconds, 12 frames | 0.2s DURATION_PROMPTLY | 1.0.0 | No | GA |
$duration-quickly0.1 seconds, 6 frames | 0.1s DURATION_QUICKLY | 1.0.0 | No | GA |
$duration-slowly0.4 seconds, 24 frames | 0.4s DURATION_SLOWLY | 1.0.0 | No | GA |
TouchTouch
Tokens that are specific to touch enabled devices
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$height-tappableTap target size for elements that rely on height or line-height | 2.75rem 44px | 2.10.0 | No | I |
$height-tappable-smallSmall tap target size for elements that rely on height or line-height | 2rem 32px | 2.10.0 | No | I |
$square-tappableTap target size for elements that rely on width and height dimensions | 2.75rem 44px | 1.0.0 | No | GA |
$square-tappable-smallSmall tap target size for elements that rely on width and height dimensions | 2rem 32px | 2.10.0 | No | I |
$square-tappable-x-smallX-small tap target size for elements that rely on width and height dimensions | 1.5rem 24px | 2.10.0 | No | I |
$square-tappable-xx-smallXx-small tap target size for elements that rely on width and height dimensions | 1.25rem 20px | 2.10.0 | No | I |
Media QueryMedia Query
Use media query tokens to set media query width ranges.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$mq-largeLarge form factor: devices larger than tablet | only screen and (min-width: 64.0625em) | 1.0.0 | No | GA |
$mq-mediumMedium form factor: devices larger than phone | only screen and (min-width: 48em) | 1.0.0 | No | GA |
$mq-medium-landscapeMedium form factor, landscape: devices larger than phone, in landscape orientation | only screen and (min-width: 48em) and (min-aspect-ratio: 4/3) | 1.0.0 | No | GA |
$mq-smallSmall form factor: devices smaller than tablet | only screen and (max-width: 47.9375em) | 1.0.0 | No | GA |
Z-indexZ-index
Use z-index tokens to set the z order layering of elements.
| Token | Example | Released | Themeable | Support |
|---|---|---|---|---|
$z-index-deepdiveDeep dive | -99999 | 1.0.0 | No | I |
$z-index-defaultDefault | 1 | 1.0.0 | No | I |
$z-index-dialogDialog | 6000 | 1.0.0 | No | I |
$z-index-dockedDocked element | 4 | 1.0.0 | No | I |
$z-index-dropdownDropdown | 7000 | 1.0.0 | No | I |
$z-index-modalModal | 9000 | 1.0.0 | No | I |
$z-index-overlayOverlay | 8000 | 1.0.0 | No | I |
$z-index-popupPopup | 5000 | 1.0.0 | No | I |
$z-index-reminderNotifications under modals | 8500 | 1.0.0 | No | I |
$z-index-spinnerSpinner | 9050 | 1.0.0 | No | I |
$z-index-stickyStickied element | 100 | 1.0.0 | No | I |
$z-index-toastToasts | 10000 | 1.0.0 | No | I |