feat(colorwheel): S2 migration #3390

cdransf · 2024-11-12T19:43:17Z

Description

CSS-1020

This change migrates the colorwheel component to S2. It adds the --spectrum-colorwheel-border-color-rgb and --spectrum-colorwheel-border-opacity custom properties. It updates --spectrum-colorwheel-border-color to leverage these tokens in an rgba(...) function.

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

Run Storybook locally or open the link for the PR.
Navigate to the colorwheel component.
Verify that no regressions are visible.

Regression testing

Validate:

The documentation pages for at least two other components are still loading, including:

The pages render correctly, are accessible, and are responsive.

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. ✨

changeset-bot · 2024-11-12T19:43:22Z

🦋 Changeset detected

Latest commit: 74f0733

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/colorwheel	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

github-actions · 2024-11-12T19:46:18Z

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

github-actions · 2024-11-12T19:49:09Z

File metrics

Summary

Total size: 2.23 MB^*
Total change (Δ): 🔴 ⬆ 1.23 KB (0.05%)

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

Package	Size	Δ
colorwheel	5.83 KB	🔴 ⬆ 1.15 KB

Details

colorwheel

Filename	Head	Compared to base
index.css	5.83 KB	🔴 ⬆ 1.15 KB (24.46%)
metadata.json	1.99 KB	🔴 ⬆ 0.09 KB (4.34%)

* 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.

marissahuysentruyt

A few questions for you, as usual!

I wonder if we need to refactor the color-wheel-width and color-wheel-minimum-width tokens from our custom tokens/dist. Those values change based on the platform (desktop/mobile), but the designs don't say anything about any size changes between desktop and mobile. In other components, they have noted the size differences. It might be something worth checking with design on. 🤷‍♀️
Do we need to adjust .spectrum-ColorWheel-border at all so that our border is actually transparent, against the color wheel, instead of outside of the color wheel? I'm not sure if the clip path is the right place, but maybe that custom property needs some tweaking? I think S2 would be the place to fix this! (because it's also not like that in main, but looking at S1 designs, it should have been).

Ours (effectively, has a gray border):

In Figma (where the border is "on top" of the color wheel):

Happy to pair on any of my comments if two heads are better than one! 👍

components/colorwheel/index.css

marissahuysentruyt · 2024-11-13T21:27:36Z

components/colorwheel/index.css

+	--spectrum-colorwheel-border-color-rgb: var(--spectrum-gray-1000-rgb);
+	--spectrum-colorwheel-border-opacity: 0.1;
+	--spectrum-colorwheel-border-color: rgba(var(--spectrum-colorwheel-border-color-rgb), var(--spectrum-colorwheel-border-opacity));
+	--spectrum-colorwheel-border-width: var(--spectrum-border-width-100);


Hm...so everything checks out right now. The border width is 1px, and if I inspect the Figma component, it also has a 1px border.

However, I read the blurb in the desktop file, and it says that the color wheel is supposed to have a 2px border? You may have already done this, but I was going to suggest we double check this with design. This change isn't listed in the changelog in Figma, so I think maybe this is outdated information. Maybe design would want to correct that 2px thing? Or update border-width-100?

I went ahead and added a comment about this to the thread I dropped into the implementations channel. I'll get both updated pending some clarification. ✨

@cdransf I can't find this Slack thread now. What ended up being the decision? Is it supposed to be 2px like the Figma description, or border-width-100 token like in the token specs?

@cdransf I can't find this Slack thread now. What ended up being the decision? Is it supposed to be 2px like the Figma description, or border-width-100 token like in the token specs?

Design closed the ticket for the tokens, so I believe they should be available in a forthcoming tokens update, but I haven't gotten a definitive answer on that yet. 🙈

cdransf · 2024-11-14T00:11:58Z

A few questions for you, as usual!

I wonder if we need to refactor the color-wheel-width and color-wheel-minimum-width tokens from our custom tokens/dist. Those values change based on the platform (desktop/mobile), but the designs don't say anything about any size changes between desktop and mobile. In other components, they have noted the size differences. It might be something worth checking with design on. 🤷‍♀️

Do we need to adjust .spectrum-ColorWheel-border at all so that our border is actually transparent, against the color wheel, instead of outside of the color wheel? I'm not sure if the clip path is the right place, but maybe that custom property needs some tweaking? I think S2 would be the place to fix this! (because it's also not like that in main, but looking at S1 designs, it should have been).

Ours (effectively, has a gray border):

In Figma (where the border is "on top" of the color wheel): ...

Happy to pair on any of my comments if two heads are better than one! 👍

I started a thread in the implementations channel about the first question — I'll go ahead and run with design's preference.

Since the border is rendered by the clip path but is associated with the div that wraps the color wheel node, I'm not sure we can fix it by adjusting the clip path (to your point). If we reduce the dimensions of the div or reduce the size of the clip path the "border" would disappear since it would render behind the color wheel. Could we render an inset border and attach it to the color wheel node directly? (Pending design approval and input.) ✨

marissahuysentruyt

Thanks for working on this! I left some ideas and comments about some of the CSS changes. I did want to run something by you...

What do you think of adjusting the default template for this component? In Figma for S1, it looks like the default did not have the color loupe, but in Figma now, the S2 color wheel has the color loupe as the default. Should we update our default story to reflect that change?

I think at the minimum maybe we should show a story with a color loupe on the docs page, and add the corresponding controls. Any thoughts on that?

marissahuysentruyt · 2025-01-29T18:16:10Z

components/colorwheel/index.css

+	--spectrum-colorwheel-border-color-rgb: var(--spectrum-gray-1000-rgb);
+	--spectrum-colorwheel-border-opacity: 0.1;
+	--spectrum-colorwheel-border-color: rgba(var(--spectrum-colorwheel-border-color-rgb), var(--spectrum-colorwheel-border-opacity));
+	--spectrum-colorwheel-border-width: var(--spectrum-border-width-100);


@cdransf I can't find this Slack thread now. What ended up being the decision? Is it supposed to be 2px like the Figma description, or border-width-100 token like in the token specs?

components/colorwheel/index.css

.changeset/giant-windows-smoke.md

components/colorwheel/index.css

marissahuysentruyt

Oh! Do we need to revisit the disabled color wheel in high contrast mode? This is what I see on Assistiv Labs. Is this intended? Should there be any sort of background color for the wheel?

cdransf · 2025-01-30T20:28:50Z

Oh! Do we need to revisit the disabled color wheel in high contrast mode? This is what I see on Assistiv Labs. Is this intended? Should there be any sort of background color for the wheel?

Addressed this in c84834: Canvas needed to be CanvasText.

cdransf added size-2 S ~6-18hrs; not hard or time consuming, one or two work days to complete. skip_vrt Add to a PR to skip running VRT (but still pass the action) ready-for-review labels Nov 12, 2024

cdransf requested review from pfulton, castastrophe, rise-erpelding and marissahuysentruyt November 12, 2024 19:43

cdransf self-assigned this Nov 12, 2024

cdransf changed the title ~~feat(colorwheel): s2 migration~~ feat(colorwheel): S2 migration Nov 12, 2024

marissahuysentruyt reviewed Nov 13, 2024

View reviewed changes

cdransf force-pushed the cdransf/s2-colorwheel-migration branch from eaf2611 to 3a12421 Compare November 14, 2024 00:15

cdransf added the blocked See description and comments for what is blocking this issue label Nov 14, 2024

cdransf force-pushed the cdransf/s2-colorwheel-migration branch 2 times, most recently from 99a6ad6 to f3be898 Compare November 20, 2024 22:30

cdransf requested a review from marissahuysentruyt November 26, 2024 16:41

cdransf removed the blocked See description and comments for what is blocking this issue label Nov 26, 2024

castastrophe force-pushed the spectrum-two branch 3 times, most recently from cdb180d to 27d01df Compare December 4, 2024 14:54

cdransf force-pushed the cdransf/s2-colorwheel-migration branch 2 times, most recently from 7ce5746 to 7af66a2 Compare December 10, 2024 15:18

cdransf force-pushed the cdransf/s2-colorwheel-migration branch 3 times, most recently from 9cb357e to 70603e0 Compare December 19, 2024 22:38

castastrophe force-pushed the spectrum-two branch 2 times, most recently from c93daf7 to e393c32 Compare December 27, 2024 18:11

castastrophe force-pushed the spectrum-two branch from 7e783b6 to e3585cd Compare January 22, 2025 17:44

cdransf force-pushed the cdransf/s2-colorwheel-migration branch from 66f5ef6 to 83ad0bd Compare January 22, 2025 17:53

rise-erpelding added the S2 Spectrum 2 label Jan 27, 2025

cdransf force-pushed the cdransf/s2-colorwheel-migration branch from 5b042e8 to c01a26b Compare January 28, 2025 15:51

cdransf requested a review from marissahuysentruyt January 28, 2025 20:03

cdransf force-pushed the cdransf/s2-colorwheel-migration branch from 4552560 to dea94d8 Compare January 29, 2025 18:08

marissahuysentruyt requested changes Jan 29, 2025

View reviewed changes

marissahuysentruyt reviewed Jan 29, 2025

View reviewed changes

cdransf force-pushed the cdransf/s2-colorwheel-migration branch 3 times, most recently from 378549e to f2aafaa Compare January 30, 2025 15:48

cdransf added 17 commits January 30, 2025 12:30

feat(colorwheel): s2 migration

8fca10f

chore(colorwheel): update property name

e8d78d1

chore(colorwheel): wip inset borders

a6c993b

chore(colorwheel): fix lint violations

df3f53c

chore(colorwheel): move mod declarations

27aea7e

chore(colorwheel): drop unused property + update metadata

f2f96b8

chore(colorwheel): remove underlying border node + class

98c56da

chore(colorwheel): remove unused property

0f83937

fix(colorwheel): add missing mod

1c25520

fix(colorwheel): comments for updated before spacing/positioning

41173d8

fix(colorwheel): adopt proper token for border opacity

06639e0

fix(colorwheel): remove inset border on disabled state

3a49d52

fix(colorwheel): remove global token reference

df9ab11

chore(colorwheel): highlight removed/added mods

5f331e3

chore(colorwheel): update copyright year

e87c600

chore(colorwheel): add color loupe to default story

7d8afd6

fix(colorwheel): correct WHC disabled background color value

74f0733

cdransf force-pushed the cdransf/s2-colorwheel-migration branch from c848343 to 74f0733 Compare January 30, 2025 20:30

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(colorwheel): S2 migration #3390

feat(colorwheel): S2 migration #3390

cdransf commented Nov 12, 2024

changeset-bot bot commented Nov 12, 2024 •

edited

Loading

github-actions bot commented Nov 12, 2024 •

edited

Loading

github-actions bot commented Nov 12, 2024 •

edited

Loading

colorwheel

marissahuysentruyt left a comment

marissahuysentruyt Nov 13, 2024

cdransf Nov 14, 2024

marissahuysentruyt Jan 29, 2025

cdransf Jan 30, 2025

cdransf commented Nov 14, 2024 •

edited

Loading

marissahuysentruyt left a comment

marissahuysentruyt Jan 29, 2025

marissahuysentruyt left a comment •

edited

Loading

cdransf commented Jan 30, 2025

feat(colorwheel): S2 migration #3390

Are you sure you want to change the base?

feat(colorwheel): S2 migration #3390

Conversation

cdransf commented Nov 12, 2024

Description

How and where has this been tested?

Validation steps

Regression testing

To-do list

changeset-bot bot commented Nov 12, 2024 • edited Loading

🦋 Changeset detected

github-actions bot commented Nov 12, 2024 • edited Loading

github-actions bot commented Nov 12, 2024 • edited Loading

File metrics

Summary

colorwheel

marissahuysentruyt left a comment

Choose a reason for hiding this comment

marissahuysentruyt Nov 13, 2024

Choose a reason for hiding this comment

cdransf Nov 14, 2024

Choose a reason for hiding this comment

marissahuysentruyt Jan 29, 2025

Choose a reason for hiding this comment

cdransf Jan 30, 2025

Choose a reason for hiding this comment

cdransf commented Nov 14, 2024 • edited Loading

marissahuysentruyt left a comment

Choose a reason for hiding this comment

marissahuysentruyt Jan 29, 2025

Choose a reason for hiding this comment

marissahuysentruyt left a comment • edited Loading

Choose a reason for hiding this comment

cdransf commented Jan 30, 2025

changeset-bot bot commented Nov 12, 2024 •

edited

Loading

github-actions bot commented Nov 12, 2024 •

edited

Loading

github-actions bot commented Nov 12, 2024 •

edited

Loading

cdransf commented Nov 14, 2024 •

edited

Loading

marissahuysentruyt left a comment •

edited

Loading