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

Components: Add hooks based VisuallyHidden #28887

Merged
merged 13 commits into from Feb 12, 2021

Conversation

sarayourfriend
Copy link
Contributor

@sarayourfriend sarayourfriend commented Feb 9, 2021

Description

Create a new VisuallyHidden based on the existing VisuallyHidden's styles but use createComponent and a new useVisuallyHidden hook.

How has this been tested?

Snapshot tests updated and tested in storybook.

Screenshots

Focused

Captura de Tela 2021-02-09 às 08 53 10

Normal

Captura de Tela 2021-02-09 às 08 53 25

Types of changes

New feature.

Checklist:

  • My code is tested.
  • My code follows the WordPress code style.
  • My code follows the accessibility standards.
  • My code has proper inline documentation.
  • I've included developer documentation if appropriate.
  • I've updated all React Native files affected by any refactorings/renamings in this PR.

@gziolo
Copy link
Member

gziolo commented Feb 9, 2021

I couldn't find CSS styles for the focused state of the VisuallyHidden component. Are they integrated into the new implementation?

Without those styles, skip links won't work properly.

@sarayourfriend
Copy link
Contributor Author

@gziolo Thanks for pointing that out, they're indeed missing, it'll be trivial to add them using the css prop, however. Fix incoming 👍🏼

@gziolo
Copy link
Member

gziolo commented Feb 9, 2021

I repeat myself, but those snapshot tests aren't very helpful. Those diffs are so gigantic that it's impossible to validate the change if you don't know the context. Therefore they don't bring too much value to the review process. We should still use them but find a better way to distill what's saved to only the bits that are important for the individual test.

@sarayourfriend
Copy link
Contributor Author

sarayourfriend commented Feb 9, 2021

@ItsJonQ Do you have any ideas what to do about the snapshot tests? I'll do a little research today to see how others have solved this issue but so far all I've seen is advise to use the emotion serializer (which we do).

Update: maybe it'd be worth trying out snapshot-diff? https://github.com/jest-community/snapshot-diff

@sarayourfriend sarayourfriend changed the title Components: Replace VisuallyHidden with hand-spun G2 version Components: Replace VisuallyHidden with CSS-in-JS version Feb 9, 2021
@sarayourfriend sarayourfriend changed the title Components: Replace VisuallyHidden with CSS-in-JS version Components: Replace VisuallyHidden with hooks version Feb 9, 2021
@gziolo
Copy link
Member

gziolo commented Feb 9, 2021

Diffing between the most basic version would be a great start.

I found this article where it's recommended: https://kentcdodds.com/blog/effective-snapshot-testing

@ItsJonQ
Copy link

ItsJonQ commented Feb 9, 2021

Do you have any ideas what to do about the snapshot tests?

@saramarcondes Not for the time being :(. Other than to skim them to ensure they look correct, and update if necessary (what we're doing now). This is of course more difficult if lower level changes affect many other snapshots.

As @saramarcondes had suggested (and Kent had mentioned in his blog post), maybe snapshot-diff can help.


Taking a step back, replacing the current VisuallyHidden with the G2 setup will mark the first substantial component we'd be refactoring. FontSizePicker happened, but it's footprint is very minimal within Gutenberg, and it is controlled with the adapters.

This VisuallyHidden update is different as it updates the current component entirely without adapters.

Having chatted with @saramarcondes , I think this would be a good candidate to increase G2 Component exposure while being mindful of risk. In theory, VisuallyHidden has very little risk as it doesn't render anything on the UI - that's it's job after all. The chances of this breaking other implements is very minimal.

For that, I'm feeling okay moving forward with this.

@gziolo Love to hear your thoughts :)

@sarayourfriend
Copy link
Contributor Author

I think I’ve got something close to working with snapshot diff:

exports[`props should render align 1`] = `
Snapshot Diff:
- First value
+ Second value

@@ -35,11 +35,11 @@
    "_values": Object {
      "--wp-g2-flex-gap": "calc(var(--wp-g2-grid-base) * 2)",
      "--wp-g2-flex-item-margin-bottom": "0",
      "--wp-g2-flex-item-margin-left": "0",
      "--wp-g2-flex-item-margin-right": "var(--wp-g2-flex-gap)",
-     "align-items": "flex-start",
+     "align-items": "center",
      "box-sizing": "border-box",
      "display": "flex",
      "flex-direction": "row",
      "font-family": "var(--wp-g2-font-family)",
      "font-weight": "var(--wp-g2-font-weight)",
`;

Only problem is snapshot diff does not play nicely with emotion (like at all) so I think we’ll need to write a custom matcher for it.

The code for the test above is this:

const { container } = render(
	<Flex align="flex-start">
		<FlexItem />
		<FlexBlock />
	</Flex>
);
expect(
	window.getComputedStyle( container.firstChild )
).toMatchDiffSnapshot(
	window.getComputedStyle( base.container.firstChild )
);

Where base is the same as container but without align set.

The custom matcher could be named something like toMatchStyleDiffSnapshot and would pass the expected and received values through getComputedStyle (or rather, whatever toHaveStyle uses because that works with emotion).

In any case, progress is being made here, just wanted to let y'all know. I should have a PR open soon with a proposal for this, either today or tomorrow.

@ItsJonQ
Copy link

ItsJonQ commented Feb 9, 2021

I should have a PR open soon with a proposal for this, either today or tomorrow.
@saramarcondes Awesome! Excited to see what you have in mind 😍

@sarayourfriend
Copy link
Contributor Author

Here y'all go: #28897

@gziolo
Copy link
Member

gziolo commented Feb 10, 2021

I would prefer we don't remove old code until there is an official proposal that is accepted. It should be a small change here.

@sarayourfriend
Copy link
Contributor Author

Sounds good, we'll just move this into the ui folder and restore the original.

@github-actions
Copy link

github-actions bot commented Feb 10, 2021

Size Change: +2.7 kB (0%)

Total Size: 1.37 MB

Filename Size Change
build/annotations/index.js 3.78 kB -2 B (0%)
build/api-fetch/index.js 3.4 kB +1 B (0%)
build/autop/index.js 2.84 kB -1 B (0%)
build/block-directory/index.js 9.1 kB +7 B (0%)
build/block-editor/index.js 124 kB +92 B (0%)
build/block-library/index.js 144 kB +10 B (0%)
build/block-serialization-default-parser/index.js 1.88 kB -1 B (0%)
build/blocks/index.js 48.2 kB +1 B (0%)
build/components/index.js 272 kB +2.56 kB (+1%)
build/compose/index.js 11 kB +3 B (0%)
build/core-data/index.js 16.8 kB +1 B (0%)
build/customize-widgets/index.js 4.08 kB +2 B (0%)
build/data-controls/index.js 829 B +2 B (0%)
build/data/index.js 8.86 kB +6 B (0%)
build/date/index.js 31.8 kB -2 B (0%)
build/dom-ready/index.js 571 B +1 B (0%)
build/edit-navigation/index.js 10.5 kB +1 B (0%)
build/edit-post/index.js 307 kB +4 B (0%)
build/edit-site/index.js 25.4 kB +3 B (0%)
build/edit-widgets/index.js 20 kB -1 B (0%)
build/editor/index.js 41.9 kB +8 B (0%)
build/element/index.js 4.61 kB -3 B (0%)
build/format-library/index.js 6.77 kB +6 B (0%)
build/hooks/index.js 2.28 kB +1 B (0%)
build/is-shallow-equal/index.js 698 B -1 B (0%)
build/keycodes/index.js 1.93 kB -1 B (0%)
build/media-utils/index.js 5.35 kB +2 B (0%)
build/notices/index.js 1.85 kB +3 B (0%)
build/nux/index.js 3.41 kB +2 B (0%)
build/plugins/index.js 2.54 kB +1 B (0%)
build/priority-queue/index.js 790 B -1 B (0%)
build/redux-routine/index.js 2.83 kB -7 B (0%)
build/reusable-blocks/index.js 2.92 kB +2 B (0%)
build/rich-text/index.js 13.4 kB +2 B (0%)
build/shortcode/index.js 1.7 kB +1 B (0%)
build/token-list/index.js 1.27 kB +1 B (0%)
ℹ️ View Unchanged
Filename Size Change
build/a11y/index.js 1.14 kB 0 B
build/blob/index.js 665 B 0 B
build/block-directory/style-rtl.css 1.01 kB 0 B
build/block-directory/style.css 1.01 kB 0 B
build/block-editor/style-rtl.css 12.1 kB 0 B
build/block-editor/style.css 12.1 kB 0 B
build/block-library/blocks/archives/editor-rtl.css 61 B 0 B
build/block-library/blocks/archives/editor.css 60 B 0 B
build/block-library/blocks/audio/editor-rtl.css 58 B 0 B
build/block-library/blocks/audio/editor.css 58 B 0 B
build/block-library/blocks/audio/style-rtl.css 103 B 0 B
build/block-library/blocks/audio/style.css 103 B 0 B
build/block-library/blocks/block/editor-rtl.css 161 B 0 B
build/block-library/blocks/block/editor.css 161 B 0 B
build/block-library/blocks/button/editor-rtl.css 475 B 0 B
build/block-library/blocks/button/editor.css 474 B 0 B
build/block-library/blocks/button/style-rtl.css 465 B 0 B
build/block-library/blocks/button/style.css 464 B 0 B
build/block-library/blocks/buttons/editor-rtl.css 233 B 0 B
build/block-library/blocks/buttons/editor.css 233 B 0 B
build/block-library/blocks/buttons/style-rtl.css 303 B 0 B
build/block-library/blocks/buttons/style.css 303 B 0 B
build/block-library/blocks/calendar/style-rtl.css 208 B 0 B
build/block-library/blocks/calendar/style.css 208 B 0 B
build/block-library/blocks/categories/editor-rtl.css 84 B 0 B
build/block-library/blocks/categories/editor.css 83 B 0 B
build/block-library/blocks/categories/style-rtl.css 79 B 0 B
build/block-library/blocks/categories/style.css 79 B 0 B
build/block-library/blocks/code/style-rtl.css 90 B 0 B
build/block-library/blocks/code/style.css 90 B 0 B
build/block-library/blocks/columns/editor-rtl.css 190 B 0 B
build/block-library/blocks/columns/editor.css 190 B 0 B
build/block-library/blocks/columns/style-rtl.css 421 B 0 B
build/block-library/blocks/columns/style.css 421 B 0 B
build/block-library/blocks/cover/editor-rtl.css 390 B 0 B
build/block-library/blocks/cover/editor.css 389 B 0 B
build/block-library/blocks/cover/style-rtl.css 1.25 kB 0 B
build/block-library/blocks/cover/style.css 1.25 kB 0 B
build/block-library/blocks/embed/editor-rtl.css 486 B 0 B
build/block-library/blocks/embed/editor.css 486 B 0 B
build/block-library/blocks/embed/style-rtl.css 396 B 0 B
build/block-library/blocks/embed/style.css 395 B 0 B
build/block-library/blocks/file/editor-rtl.css 199 B 0 B
build/block-library/blocks/file/editor.css 198 B 0 B
build/block-library/blocks/file/style-rtl.css 248 B 0 B
build/block-library/blocks/file/style.css 248 B 0 B
build/block-library/blocks/freeform/editor-rtl.css 2.45 kB 0 B
build/block-library/blocks/freeform/editor.css 2.45 kB 0 B
build/block-library/blocks/gallery/editor-rtl.css 679 B 0 B
build/block-library/blocks/gallery/editor.css 679 B 0 B
build/block-library/blocks/gallery/style-rtl.css 1.07 kB 0 B
build/block-library/blocks/gallery/style.css 1.06 kB 0 B
build/block-library/blocks/group/editor-rtl.css 318 B 0 B
build/block-library/blocks/group/editor.css 317 B 0 B
build/block-library/blocks/group/style-rtl.css 57 B 0 B
build/block-library/blocks/group/style.css 57 B 0 B
build/block-library/blocks/heading/editor-rtl.css 129 B 0 B
build/block-library/blocks/heading/editor.css 129 B 0 B
build/block-library/blocks/heading/style-rtl.css 76 B 0 B
build/block-library/blocks/heading/style.css 76 B 0 B
build/block-library/blocks/html/editor-rtl.css 281 B 0 B
build/block-library/blocks/html/editor.css 281 B 0 B
build/block-library/blocks/image/editor-rtl.css 717 B 0 B
build/block-library/blocks/image/editor.css 716 B 0 B
build/block-library/blocks/image/style-rtl.css 477 B 0 B
build/block-library/blocks/image/style.css 478 B 0 B
build/block-library/blocks/latest-comments/editor-rtl.css 159 B 0 B
build/block-library/blocks/latest-comments/editor.css 158 B 0 B
build/block-library/blocks/latest-comments/style-rtl.css 269 B 0 B
build/block-library/blocks/latest-comments/style.css 269 B 0 B
build/block-library/blocks/latest-posts/editor-rtl.css 137 B 0 B
build/block-library/blocks/latest-posts/editor.css 137 B 0 B
build/block-library/blocks/latest-posts/style-rtl.css 523 B 0 B
build/block-library/blocks/latest-posts/style.css 522 B 0 B
build/block-library/blocks/list/editor-rtl.css 65 B 0 B
build/block-library/blocks/list/editor.css 65 B 0 B
build/block-library/blocks/list/style-rtl.css 63 B 0 B
build/block-library/blocks/list/style.css 63 B 0 B
build/block-library/blocks/media-text/editor-rtl.css 191 B 0 B
build/block-library/blocks/media-text/editor.css 191 B 0 B
build/block-library/blocks/media-text/style-rtl.css 535 B 0 B
build/block-library/blocks/media-text/style.css 532 B 0 B
build/block-library/blocks/more/editor-rtl.css 434 B 0 B
build/block-library/blocks/more/editor.css 434 B 0 B
build/block-library/blocks/navigation-link/editor-rtl.css 395 B 0 B
build/block-library/blocks/navigation-link/editor.css 397 B 0 B
build/block-library/blocks/navigation-link/style-rtl.css 704 B 0 B
build/block-library/blocks/navigation-link/style.css 702 B 0 B
build/block-library/blocks/navigation/editor-rtl.css 1.34 kB 0 B
build/block-library/blocks/navigation/editor.css 1.34 kB 0 B
build/block-library/blocks/navigation/style-rtl.css 195 B 0 B
build/block-library/blocks/navigation/style.css 195 B 0 B
build/block-library/blocks/nextpage/editor-rtl.css 395 B 0 B
build/block-library/blocks/nextpage/editor.css 395 B 0 B
build/block-library/blocks/page-list/editor-rtl.css 214 B 0 B
build/block-library/blocks/page-list/editor.css 214 B 0 B
build/block-library/blocks/page-list/style-rtl.css 527 B 0 B
build/block-library/blocks/page-list/style.css 526 B 0 B
build/block-library/blocks/paragraph/editor-rtl.css 109 B 0 B
build/block-library/blocks/paragraph/editor.css 109 B 0 B
build/block-library/blocks/paragraph/style-rtl.css 273 B 0 B
build/block-library/blocks/paragraph/style.css 273 B 0 B
build/block-library/blocks/post-author/editor-rtl.css 209 B 0 B
build/block-library/blocks/post-author/editor.css 209 B 0 B
build/block-library/blocks/post-author/style-rtl.css 183 B 0 B
build/block-library/blocks/post-author/style.css 184 B 0 B
build/block-library/blocks/post-comments-form/style-rtl.css 250 B 0 B
build/block-library/blocks/post-comments-form/style.css 250 B 0 B
build/block-library/blocks/post-content/editor-rtl.css 139 B 0 B
build/block-library/blocks/post-content/editor.css 139 B 0 B
build/block-library/blocks/post-excerpt/editor-rtl.css 73 B 0 B
build/block-library/blocks/post-excerpt/editor.css 73 B 0 B
build/block-library/blocks/post-featured-image/editor-rtl.css 338 B 0 B
build/block-library/blocks/post-featured-image/editor.css 338 B 0 B
build/block-library/blocks/post-featured-image/style-rtl.css 100 B 0 B
build/block-library/blocks/post-featured-image/style.css 100 B 0 B
build/block-library/blocks/preformatted/style-rtl.css 63 B 0 B
build/block-library/blocks/preformatted/style.css 63 B 0 B
build/block-library/blocks/pullquote/editor-rtl.css 183 B 0 B
build/block-library/blocks/pullquote/editor.css 183 B 0 B
build/block-library/blocks/pullquote/style-rtl.css 316 B 0 B
build/block-library/blocks/pullquote/style.css 316 B 0 B
build/block-library/blocks/query-loop/editor-rtl.css 90 B 0 B
build/block-library/blocks/query-loop/editor.css 89 B 0 B
build/block-library/blocks/query-loop/style-rtl.css 315 B 0 B
build/block-library/blocks/query-loop/style.css 317 B 0 B
build/block-library/blocks/query-pagination-numbers/editor-rtl.css 122 B 0 B
build/block-library/blocks/query-pagination-numbers/editor.css 121 B 0 B
build/block-library/blocks/query-pagination/editor-rtl.css 270 B 0 B
build/block-library/blocks/query-pagination/editor.css 262 B 0 B
build/block-library/blocks/query-pagination/style-rtl.css 168 B 0 B
build/block-library/blocks/query-pagination/style.css 168 B 0 B
build/block-library/blocks/query/editor-rtl.css 159 B 0 B
build/block-library/blocks/query/editor.css 160 B 0 B
build/block-library/blocks/quote/editor-rtl.css 61 B 0 B
build/block-library/blocks/quote/editor.css 61 B 0 B
build/block-library/blocks/quote/style-rtl.css 169 B 0 B
build/block-library/blocks/quote/style.css 169 B 0 B
build/block-library/blocks/rss/editor-rtl.css 201 B 0 B
build/block-library/blocks/rss/editor.css 202 B 0 B
build/block-library/blocks/rss/style-rtl.css 290 B 0 B
build/block-library/blocks/rss/style.css 290 B 0 B
build/block-library/blocks/search/editor-rtl.css 165 B 0 B
build/block-library/blocks/search/editor.css 165 B 0 B
build/block-library/blocks/search/style-rtl.css 342 B 0 B
build/block-library/blocks/search/style.css 344 B 0 B
build/block-library/blocks/separator/editor-rtl.css 99 B 0 B
build/block-library/blocks/separator/editor.css 99 B 0 B
build/block-library/blocks/separator/style-rtl.css 236 B 0 B
build/block-library/blocks/separator/style.css 236 B 0 B
build/block-library/blocks/shortcode/editor-rtl.css 504 B 0 B
build/block-library/blocks/shortcode/editor.css 504 B 0 B
build/block-library/blocks/site-logo/editor-rtl.css 201 B 0 B
build/block-library/blocks/site-logo/editor.css 201 B 0 B
build/block-library/blocks/site-logo/style-rtl.css 117 B 0 B
build/block-library/blocks/site-logo/style.css 117 B 0 B
build/block-library/blocks/social-link/editor-rtl.css 164 B 0 B
build/block-library/blocks/social-link/editor.css 165 B 0 B
build/block-library/blocks/social-links/editor-rtl.css 696 B 0 B
build/block-library/blocks/social-links/editor.css 696 B 0 B
build/block-library/blocks/social-links/style-rtl.css 1.37 kB 0 B
build/block-library/blocks/social-links/style.css 1.37 kB 0 B
build/block-library/blocks/spacer/editor-rtl.css 302 B 0 B
build/block-library/blocks/spacer/editor.css 302 B 0 B
build/block-library/blocks/spacer/style-rtl.css 48 B 0 B
build/block-library/blocks/spacer/style.css 48 B 0 B
build/block-library/blocks/subhead/editor-rtl.css 99 B 0 B
build/block-library/blocks/subhead/editor.css 99 B 0 B
build/block-library/blocks/subhead/style-rtl.css 80 B 0 B
build/block-library/blocks/subhead/style.css 80 B 0 B
build/block-library/blocks/table/editor-rtl.css 489 B 0 B
build/block-library/blocks/table/editor.css 489 B 0 B
build/block-library/blocks/table/style-rtl.css 386 B 0 B
build/block-library/blocks/table/style.css 386 B 0 B
build/block-library/blocks/tag-cloud/editor-rtl.css 118 B 0 B
build/block-library/blocks/tag-cloud/editor.css 118 B 0 B
build/block-library/blocks/tag-cloud/style-rtl.css 94 B 0 B
build/block-library/blocks/tag-cloud/style.css 94 B 0 B
build/block-library/blocks/template-part/editor-rtl.css 557 B 0 B
build/block-library/blocks/template-part/editor.css 556 B 0 B
build/block-library/blocks/text-columns/editor-rtl.css 95 B 0 B
build/block-library/blocks/text-columns/editor.css 95 B 0 B
build/block-library/blocks/text-columns/style-rtl.css 166 B 0 B
build/block-library/blocks/text-columns/style.css 166 B 0 B
build/block-library/blocks/verse/editor-rtl.css 62 B 0 B
build/block-library/blocks/verse/editor.css 62 B 0 B
build/block-library/blocks/verse/style-rtl.css 87 B 0 B
build/block-library/blocks/verse/style.css 87 B 0 B
build/block-library/blocks/video/editor-rtl.css 504 B 0 B
build/block-library/blocks/video/editor.css 503 B 0 B
build/block-library/blocks/video/style-rtl.css 193 B 0 B
build/block-library/blocks/video/style.css 193 B 0 B
build/block-library/common-rtl.css 1.01 kB 0 B
build/block-library/common.css 1.01 kB 0 B
build/block-library/editor-rtl.css 9.04 kB 0 B
build/block-library/editor.css 9.03 kB 0 B
build/block-library/style-rtl.css 8.8 kB 0 B
build/block-library/style.css 8.8 kB 0 B
build/block-library/theme-rtl.css 748 B 0 B
build/block-library/theme.css 748 B 0 B
build/block-serialization-spec-parser/index.js 3.06 kB 0 B
build/components/style-rtl.css 15.5 kB 0 B
build/components/style.css 15.5 kB 0 B
build/customize-widgets/style-rtl.css 168 B 0 B
build/customize-widgets/style.css 168 B 0 B
build/deprecated/index.js 769 B 0 B
build/dom/index.js 4.94 kB 0 B
build/edit-navigation/style-rtl.css 1.18 kB 0 B
build/edit-navigation/style.css 1.18 kB 0 B
build/edit-post/style-rtl.css 6.79 kB 0 B
build/edit-post/style.css 6.78 kB 0 B
build/edit-site/style-rtl.css 4.37 kB 0 B
build/edit-site/style.css 4.37 kB 0 B
build/edit-widgets/style-rtl.css 3.2 kB 0 B
build/edit-widgets/style.css 3.2 kB 0 B
build/editor/editor-styles-rtl.css 543 B 0 B
build/editor/editor-styles.css 545 B 0 B
build/editor/style-rtl.css 3.89 kB 0 B
build/editor/style.css 3.89 kB 0 B
build/escape-html/index.js 735 B 0 B
build/format-library/style-rtl.css 637 B 0 B
build/format-library/style.css 639 B 0 B
build/html-entities/index.js 622 B 0 B
build/i18n/index.js 4.01 kB 0 B
build/keyboard-shortcuts/index.js 2.53 kB 0 B
build/list-reusable-blocks/index.js 3.15 kB 0 B
build/list-reusable-blocks/style-rtl.css 629 B 0 B
build/list-reusable-blocks/style.css 628 B 0 B
build/nux/style-rtl.css 731 B 0 B
build/nux/style.css 727 B 0 B
build/primitives/index.js 1.42 kB 0 B
build/react-i18n/index.js 1.45 kB 0 B
build/server-side-render/index.js 2.77 kB 0 B
build/url/index.js 3.01 kB 0 B
build/viewport/index.js 1.85 kB 0 B
build/warning/index.js 1.14 kB 0 B
build/wordcount/index.js 1.22 kB 0 B

compressed-size-action

@sarayourfriend sarayourfriend changed the title Components: Replace VisuallyHidden with hooks version Components: Add hooks based VisuallyHidden Feb 10, 2021
export function useVisuallyHidden( { className, ...props } ) {
// circumvent the context system and write the classnames ourselves
const classes = cx(
'components-visually-hidden wp-components-visually-hidden',
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Out of curiosity, why does it have two similar class names?

The old implementation uses only components-visually-hidden.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

G2 introduces the wp- prefixed classname. Typically they'd be added by useContextSystem here: https://github.com/ItsJonQ/g2/blob/5feb4f2822efcd67afbf3f52849c78b8cbfd0f82/packages/context/src/use-context-system.js#L95

For consistency's sake I added both to the hooks version.

@gziolo
Copy link
Member

gziolo commented Feb 11, 2021

Some things I observe here and in general. Those are nitpicking to consider but they might help with further work:

  • other components expose both the component and its hook, I wouldn't mind if you would keep it the same for everything if only possible
  • for other components index.js only re-exports public API, the hook is in the use-component-name.js and the component is in component-name.js, should we standardize it and simplify the naming of the files, how do you feel about:
    • index.js
    • component.js
    • hook.js
    • I wouldn't mind if we wouldn't repeat the name of the component in paths like component-name/component-name-*.js
  • can we have at least one unit test for every component? in this case, is it even possible to validate if the component isn't visible with all the testing tools? a snapshot could be fine otherwise 😄

Should we connect the new component using withNext liker here:

export function withNextComponent( current ) {
return withNext( current, FontSizePicker, 'WPComponentsFontSizePicker' );
}

or do you think it isn't worth it?

@sarayourfriend
Copy link
Contributor Author

Should we connect the new component using withNext liker here:

I don't think this is necessary considering there is no need for a props adapter, we can just swap out the references directly, right?

Or should we do it so that we can swap them using the context system globally?

@ItsJonQ
Copy link

ItsJonQ commented Feb 11, 2021

...should we standardize it and simplify the naming of the files

I'm happy with anything.

For context, I'm personally use to naming conventions I have in the @itsjonq/g2 repo (which I mirrored from other projects in this component library space). It doesn't matter though 😊 .

The only thing the proposed naming system doesn't address is sub-components 🤔

(Let's pretend there's a list component)

src/components/ui/list/

  • index.js
  • component.js
  • hook.js
  • utils.js (maybe?)
  • list-item.js (or would it be item.js)

(I think list-item.js would be easiest)


Should we connect the new component using withNext liker here:

@gziolo Since we're adding this (new) VisuallyHidden under the /ui directory, rather than replacing the existing one, I think it makes sense to wrap the existing one with the withNext() HOC so we can migrate it

@gziolo
Copy link
Member

gziolo commented Feb 11, 2021

It's a tricky part to name files. We were using mostly index.js in other places and then the name of the component would match the folder name. If there are other components then usually you will see the unique part of the component name as the name of the file. I'm mostly thinking about consistency so we you can quickly get the pattern when extending functionality.

@sarayourfriend
Copy link
Contributor Author

@gziolo @ItsJonQ Does this look good to go?

@gziolo
Copy link
Member

gziolo commented Feb 12, 2021

Screen Shot 2021-02-12 at 17 56 48

Any idea where this error comes from? Would rebase help? Otherwise, it's ✅ from me.

@sarayourfriend sarayourfriend merged commit 198fa44 into master Feb 12, 2021
@sarayourfriend sarayourfriend deleted the try/replace-visually-hidden branch February 12, 2021 19:56
@github-actions github-actions bot added this to the Gutenberg 10.1 milestone Feb 12, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Feature] Component System WordPress component system [Package] Components /packages/components
Projects
No open projects
Development

Successfully merging this pull request may close these issues.

None yet

3 participants