@spectrum-web-components/styles

Description

Spectrum Web Components are a LitElement-powered web component library of patterns built on top of the Spectrum CSS specification. Styles for these components are made available (and, in some cases, customizable) via CSS Custom Properties, e.g. var(--spectrum-black). In this package, you will find the CSS Custom Properties that power the various color and size themes defined by Spectrum CSS.

The easiest way to consume these values is via the <sp-theme> element. However, in some cases, it can be useful to have direct access to the files outlining the CSS Custom Properties, on top of which the rest of the component system is built.

Usage

yarn add @spectrum-web-components/styles

Theme packages

@import '@spectrum-web-components/styles/all-medium-darkest.css';

This file brings together the global variables and font settings with the "Darkest" color set and "Medium" scale system specification.

@import '@spectrum-web-components/styles/all-medium-dark.css';

This file brings together the global variables and font settings with the "Dark" color set and "Medium" scale system specification.

@import '@spectrum-web-components/styles/all-medium-light.css';

This file brings together the global variables and font settings with the "Light" color set and "Medium" scale system specification.

@import '@spectrum-web-components/styles/all-medium-lightest.css';

This file brings together the global variables and font settings with the "Lightest" color set and "Medium" scale system specification.

@import '@spectrum-web-components/styles/all-large-darkest.css';

This file brings together the global variables and font settings with the "Darkest" color set and "Large" scale system specification.

@import '@spectrum-web-components/styles/all-large-dark.css';

This file brings together the global variables and font settings with the "Dark" color set and "Large" scale system specification.

@import '@spectrum-web-components/styles/all-large-light.css';

This file brings together the global variables and font settings with the "Light" color set and "Large" scale system specification.

@import '@spectrum-web-components/styles/all-large-lightest.css';

This file brings together the global variables and font settings with the "Lightest" color set and "Large" scale system specification.

Color sets

Darkest

@import '@spectrum-web-components/styles/theme-darkest.css';

This file provides only the variables needed to power a color palette featuring colors found in the "Darkest" theme.

Dark

@import '@spectrum-web-components/styles/theme-dark.css';

This file provides only the variables needed to power a color palette featuring colors found in the "Dark" theme.

Light

@import '@spectrum-web-components/styles/theme-light.css';

This file provides only the variables needed to power a color palette featuring colors found in the "Light" theme.

Lightest

@import '@spectrum-web-components/styles/theme-lightest.css';

This file provides only the variables needed to power a color palette featuring colors found in the "Lightest" theme.

Scale

Medium

@import '@spectrum-web-components/styles/scale-medium.css';

This file provides only the variables needed to power the "Medium" scale system specification.

Large

@import '@spectrum-web-components/styles/scale-large.css';

This file provides only the variables needed to power the "Large" scale system specification.

Typography

@import '@spectrum-web-components/styles/typography.css';

This file provides a lit-html compliant version of the Spectrum Typography classes.

Changelog

1.5.0 (2025-04-15)

Minor Changes

sp-icons-workflow: Added missing S2 icons

Patch Changes

sp-popover: 📝 #​3566 Thanks @​aramos-adobe!

Popover overflow bug on Safari

• translateZ has been added to the open popover to prevent clipping of the filter: drop-shadow when overflow is applied. translateZ or translate3d on the open state accelerates the component to the GPU layer maintaining any transformations and animations.
• overflow: visible applied to CSS *--withTip so the tip is still visible if overflow is applied to the component.

sp-picker: PickerBase(used in <sp-picker> and sp-action-menu>):

Fixes focus so that it is not set on <sp-menu-item> elements when opened via mouse.

A keyboard interaction is the only interaction that should set focus on an <sp-menu-item> when the menu is opened. A user with a mouse would expect the focus to stay where the mouse is.

Fixes: #2950

sp-button: Updated the deprecation warning to allow variant and static-color exist on the same component. Added primary and secondary stories to white and black button directories on storybook. Updates documentation site to reflect this as well.

sp-infield-button: # Release Note

Infield Button