Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(breadcrumb)!: spectrum 2 migration #3395

Open
wants to merge 8 commits into
base: spectrum-two
Choose a base branch
from

Conversation

jawinn
Copy link
Collaborator

@jawinn jawinn commented Nov 13, 2024

Description

Breadcrumbs Spectrum 2 Migration

The breadcrumbs component is now updated to use the S2 specs and tokens. This includes updated spacing, heights, colors, font sizes, etc. This does not currently include the updated S2 icons.

There has been a major design change to the variant classes related to density and sizing, to align their terminology better with t-shirt sizes:

  • The "compact" variant no longer exists. The spectrum-Breadcrumbs--compact class and associated custom properties are removed. The default (medium) breadcrumbs are now sized similar to what was previously called compact.
  • There is a new "large" variant, which uses the spectrum-Breadcrumbs--large class. This is sized similarly to what was previously the default.

The breadcrumb title can now be customized in the multiline variant using an additional element that uses the typography component's heading classes. This and its preferred sizing have been added to the documentation, a new Docs example, and a new Storybook control titleHeadingSize. Design notes for reference:

The title item can be customized in the multiline variant, but the preferred sizes are Heading (S), Heading (M), Heading (L) (default), and Heading (XL)

The component has been refactored to slim down and simplify its CSS and custom properties, by changing the values of existing custom properties for large and multiline variants.

The following mod custom properties have been removed:

  • --mod-breadcrumbs-action-button-spacing-block-between-multiline
  • --mod-breadcrumbs-action-button-spacing-block-compact
  • --mod-breadcrumbs-action-button-spacing-block-multiline
  • --mod-breadcrumbs-block-size-compact
  • --mod-breadcrumbs-block-size-multiline
  • --mod-breadcrumbs-font-family-compact
  • --mod-breadcrumbs-font-family-compact-current
  • --mod-breadcrumbs-font-family-multiline
  • --mod-breadcrumbs-font-family-multiline-current
  • --mod-breadcrumbs-font-size-compact
  • --mod-breadcrumbs-font-size-compact-current
  • --mod-breadcrumbs-font-size-multiline
  • --mod-breadcrumbs-font-size-multiline-current
  • --mod-breadcrumbs-font-weight-compact
  • --mod-breadcrumbs-font-weight-compact-current
  • --mod-breadcrumbs-font-weight-multiline
  • --mod-breadcrumbs-font-weight-multiline-current
  • --mod-breadcrumbs-icon-spacing-block-between-multiline
  • --mod-breadcrumbs-icon-spacing-block-compact
  • --mod-breadcrumbs-icon-spacing-block-start-multiline
  • --mod-breadcrumbs-text-spacing-block-between-multiline
  • --mod-breadcrumbs-text-spacing-block-end-compact
  • --mod-breadcrumbs-text-spacing-block-end-multiline
  • --mod-breadcrumbs-text-spacing-block-start-compact
  • --mod-breadcrumbs-text-spacing-block-start-multiline

The following mod custom properties have been renamed:

  • --spectrum-breadcrumbs-action-button-spacing-inline-start is now --spectrum-breadcrumbs-inline-start-to-truncated-menu to help clarify what it is used for. The general action button inline spacing is already handled by --mod-breadcrumbs-action-button-spacing-inline.

CSS-811

How and where has this been tested?

Please tag yourself on the tests you've marked complete to confirm the tests have been run by someone other than the author.

Validation steps

  • Breadcrumbs compared against S2 spec
  • New variant "large" exists and "compact" no longer exists
  • New control titleHeadingSize works as expected and documentation around this is clear

Regression testing

Validate:

  1. The documentation pages for at least two other components are still loading, including:
  • The pages render correctly, are accessible, and are responsive.
  1. If components have been modified, VRTs have been run on this branch:
  • VRTs have been run and looked at.
  • Any VRT changes have been accepted (by reviewer and/or PR author), or there are no changes.

To-do list

  • I have read the contribution guidelines.
  • I have updated relevant storybook stories and templates.
  • I have tested these changes in Windows High Contrast mode.
  • If my change impacts other components, I have tested to make sure they don't break.
  • If my change impacts documentation, I have updated the documentation accordingly.
  • ✨ This pull request is ready to merge. ✨

Current changes on main, including bugfixes, to assist with testing with
s2, until the base branch is updated with main.
The options and naming around densities has changed in s2. There is now:
- Medium / default (was previously "compact")
- Large (was previously default)
- Multiline (existing)

This updates the controls, classes, and tokens around that.

It also sets the bulk of the new values for existing custom properties
that have changed in s2.
Leverage changing custom property values for --large and --multiline,
instead of creating new properties for every variant. This reduces the
number of custom properties and slims down the CSS.
Pulls in most of the stories from main, and changes compact stories to
large stories--

This commit can be modified or dropped once spectrum-two is up to date
with all of the stories and template changes on main. This excludes
BreadcrumbGroup, test.js, etc.
Finalize use of s2 tokens defined in design, including new tokens and
changes. Adjusts which multiline tokens are applied.
Copy link

changeset-bot bot commented Nov 13, 2024

🦋 Changeset detected

Latest commit: 24f863b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@spectrum-css/breadcrumb Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@jawinn jawinn added S2 Spectrum 2 size-3 M ~18-30hrs; moderate effort or complexity, several work days needed. labels Nov 13, 2024
@jawinn jawinn changed the title feat(breadcrumb): spectrum 2 migration feat(breadcrumb)!: spectrum 2 migration Nov 13, 2024
The new specs specified that title item can be customized in the
multiline variant, with preferred sizing. This adds support for that
in our template and adds a new Storybook control.
@jawinn jawinn force-pushed the jawinn/css-811-s2-breadcrumbs branch from 88c8ac3 to a819f2b Compare November 13, 2024 17:38
Copy link
Contributor

github-actions bot commented Nov 13, 2024

File metrics

Summary

Total size: 4.28 MB*
Total change (Δ): ⬇ 12.26 KB (-0.28%)

Table reports on changes to a package's main file. Other changes can be found in the collapsed Details section below.

Package Size Δ
breadcrumb 13.53 KB ⬇ 3.18 KB

Details

breadcrumb

File Head Base Δ
index-base.css 13.53 KB 16.71 KB ⬇ 3.18 KB (-19.05%)
index-vars.css 13.53 KB 16.71 KB ⬇ 3.18 KB (-19.05%)
index.css 13.53 KB 16.71 KB ⬇ 3.18 KB (-19.05%)
metadata.json 7.00 KB 9.72 KB ⬇ 2.72 KB (-27.95%)
* Size determined by adding together the size of the main file for all packages in the library.
* Results are not gzipped or minified.
* An ASCII character in UTF-8 is 8 bits or 1 byte.

Copy link
Contributor

github-actions bot commented Nov 13, 2024

🚀 Deployed on https://pr-3395--spectrum-css.netlify.app

@jawinn jawinn marked this pull request as draft November 13, 2024 19:31
Adjusts some spacings and the tokens used to make sure that this is
adhering to the tokens defined on the design spec.

Of note, this helps fix:
- Too much horizontal spacing beside truncated menu; there needed to be
  different spacing for text to separator and truncated menu to
  separator. To allow this be changed, some margins/paddings were
  moved around to different elements than before.
- Uses correct start edge spacing (previously padding on the ul), which
  needs to be different for text items and the truncated menu item.
@jawinn
Copy link
Collaborator Author

jawinn commented Nov 14, 2024

I am seeing one issue where the text is rendering a little too high and those elements are greater than 32px tall (33.19px). This is related to line-height and the top and bottom padding token values, which is very similar to the discussion raised a few months back about button and line-height tokens. I'll bring this up with design again in Slack:
Screenshot 2024-11-14 at 2 58 25 PM

@jawinn jawinn marked this pull request as ready for review November 14, 2024 20:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ready-for-review S2 Spectrum 2 size-3 M ~18-30hrs; moderate effort or complexity, several work days needed.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant