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

Revert "Revert "components: Promote VisuallyHidden from ui into full components (#31244)"" #31902

Merged
merged 8 commits into from
Jul 17, 2021

Conversation

sarayourfriend
Copy link
Contributor

Reverts #31882

@github-actions
Copy link

github-actions bot commented May 17, 2021

Size Change: -558 B (0%)

Total Size: 1.07 MB

Filename Size Change
build/a11y/index.min.js 1.12 kB +2 B (0%)
build/block-directory/index.min.js 6.62 kB -1 B (0%)
build/block-editor/index.min.js 126 kB +14 B (0%)
build/block-library/index.min.js 147 kB -1 B (0%)
build/blocks/index.min.js 47.2 kB -3 B (0%)
build/components/index.min.js 196 kB -276 B (0%)
build/components/style-rtl.css 15.9 kB -153 B (-1%)
build/components/style.css 15.9 kB -153 B (-1%)
build/compose/index.min.js 10.2 kB +2 B (0%)
build/core-data/index.min.js 12.4 kB +4 B (0%)
build/customize-widgets/index.min.js 10.3 kB -1 B (0%)
build/data-controls/index.min.js 829 B +2 B (0%)
build/data/index.min.js 7.22 kB +1 B (0%)
build/deprecated/index.min.js 738 B +1 B (0%)
build/edit-navigation/index.min.js 13.9 kB -4 B (0%)
build/edit-post/index.min.js 59.5 kB +3 B (0%)
build/edit-site/index.min.js 25.9 kB -3 B (0%)
build/edit-widgets/index.min.js 16.2 kB -4 B (0%)
build/editor/index.min.js 38.7 kB +6 B (0%)
build/format-library/index.min.js 5.71 kB +1 B (0%)
build/hooks/index.min.js 1.76 kB +1 B (0%)
build/i18n/index.min.js 3.73 kB +2 B (0%)
build/keyboard-shortcuts/index.min.js 1.74 kB -1 B (0%)
build/media-utils/index.min.js 3.08 kB +1 B (0%)
build/priority-queue/index.min.js 791 B +1 B (0%)
build/reusable-blocks/index.min.js 2.56 kB -2 B (0%)
build/rich-text/index.min.js 10.8 kB -2 B (0%)
build/server-side-render/index.min.js 1.63 kB -2 B (0%)
build/shortcode/index.min.js 1.68 kB +1 B (0%)
build/warning/index.min.js 1.16 kB +5 B (0%)
build/widgets/index.min.js 6.48 kB +1 B (0%)
ℹ️ View Unchanged
Filename Size
build/admin-manifest/index.min.js 1.41 kB
build/annotations/index.min.js 2.93 kB
build/api-fetch/index.min.js 2.44 kB
build/autop/index.min.js 2.28 kB
build/blob/index.min.js 673 B
build/block-directory/style-rtl.css 1.02 kB
build/block-directory/style.css 1.02 kB
build/block-editor/style-rtl.css 14 kB
build/block-editor/style.css 14 kB
build/block-library/blocks/archives/editor-rtl.css 61 B
build/block-library/blocks/archives/editor.css 60 B
build/block-library/blocks/archives/style-rtl.css 65 B
build/block-library/blocks/archives/style.css 65 B
build/block-library/blocks/audio/editor-rtl.css 58 B
build/block-library/blocks/audio/editor.css 58 B
build/block-library/blocks/audio/style-rtl.css 112 B
build/block-library/blocks/audio/style.css 112 B
build/block-library/blocks/audio/theme-rtl.css 125 B
build/block-library/blocks/audio/theme.css 125 B
build/block-library/blocks/block/editor-rtl.css 161 B
build/block-library/blocks/block/editor.css 161 B
build/block-library/blocks/button/editor-rtl.css 475 B
build/block-library/blocks/button/editor.css 474 B
build/block-library/blocks/button/style-rtl.css 603 B
build/block-library/blocks/button/style.css 602 B
build/block-library/blocks/buttons/editor-rtl.css 315 B
build/block-library/blocks/buttons/editor.css 315 B
build/block-library/blocks/buttons/style-rtl.css 375 B
build/block-library/blocks/buttons/style.css 375 B
build/block-library/blocks/calendar/style-rtl.css 208 B
build/block-library/blocks/calendar/style.css 208 B
build/block-library/blocks/categories/editor-rtl.css 84 B
build/block-library/blocks/categories/editor.css 83 B
build/block-library/blocks/categories/style-rtl.css 79 B
build/block-library/blocks/categories/style.css 79 B
build/block-library/blocks/code/style-rtl.css 90 B
build/block-library/blocks/code/style.css 90 B
build/block-library/blocks/code/theme-rtl.css 131 B
build/block-library/blocks/code/theme.css 131 B
build/block-library/blocks/columns/editor-rtl.css 190 B
build/block-library/blocks/columns/editor.css 190 B
build/block-library/blocks/columns/style-rtl.css 475 B
build/block-library/blocks/columns/style.css 476 B
build/block-library/blocks/cover/editor-rtl.css 670 B
build/block-library/blocks/cover/editor.css 670 B
build/block-library/blocks/cover/style-rtl.css 1.22 kB
build/block-library/blocks/cover/style.css 1.23 kB
build/block-library/blocks/embed/editor-rtl.css 486 B
build/block-library/blocks/embed/editor.css 486 B
build/block-library/blocks/embed/style-rtl.css 401 B
build/block-library/blocks/embed/style.css 400 B
build/block-library/blocks/embed/theme-rtl.css 124 B
build/block-library/blocks/embed/theme.css 124 B
build/block-library/blocks/file/editor-rtl.css 301 B
build/block-library/blocks/file/editor.css 300 B
build/block-library/blocks/file/style-rtl.css 255 B
build/block-library/blocks/file/style.css 255 B
build/block-library/blocks/file/view.min.js 780 B
build/block-library/blocks/freeform/editor-rtl.css 2.44 kB
build/block-library/blocks/freeform/editor.css 2.44 kB
build/block-library/blocks/gallery/editor-rtl.css 704 B
build/block-library/blocks/gallery/editor.css 705 B
build/block-library/blocks/gallery/style-rtl.css 1.06 kB
build/block-library/blocks/gallery/style.css 1.06 kB
build/block-library/blocks/gallery/theme-rtl.css 122 B
build/block-library/blocks/gallery/theme.css 122 B
build/block-library/blocks/group/editor-rtl.css 160 B
build/block-library/blocks/group/editor.css 160 B
build/block-library/blocks/group/style-rtl.css 57 B
build/block-library/blocks/group/style.css 57 B
build/block-library/blocks/group/theme-rtl.css 93 B
build/block-library/blocks/group/theme.css 93 B
build/block-library/blocks/heading/editor-rtl.css 152 B
build/block-library/blocks/heading/editor.css 152 B
build/block-library/blocks/heading/style-rtl.css 76 B
build/block-library/blocks/heading/style.css 76 B
build/block-library/blocks/home-link/style-rtl.css 247 B
build/block-library/blocks/home-link/style.css 247 B
build/block-library/blocks/html/editor-rtl.css 281 B
build/block-library/blocks/html/editor.css 281 B
build/block-library/blocks/image/editor-rtl.css 729 B
build/block-library/blocks/image/editor.css 727 B
build/block-library/blocks/image/style-rtl.css 481 B
build/block-library/blocks/image/style.css 485 B
build/block-library/blocks/image/theme-rtl.css 124 B
build/block-library/blocks/image/theme.css 124 B
build/block-library/blocks/latest-comments/style-rtl.css 286 B
build/block-library/blocks/latest-comments/style.css 286 B
build/block-library/blocks/latest-posts/editor-rtl.css 137 B
build/block-library/blocks/latest-posts/editor.css 137 B
build/block-library/blocks/latest-posts/style-rtl.css 526 B
build/block-library/blocks/latest-posts/style.css 524 B
build/block-library/blocks/list/style-rtl.css 63 B
build/block-library/blocks/list/style.css 63 B
build/block-library/blocks/media-text/editor-rtl.css 263 B
build/block-library/blocks/media-text/editor.css 264 B
build/block-library/blocks/media-text/style-rtl.css 492 B
build/block-library/blocks/media-text/style.css 489 B
build/block-library/blocks/more/editor-rtl.css 434 B
build/block-library/blocks/more/editor.css 434 B
build/block-library/blocks/navigation-link/editor-rtl.css 474 B
build/block-library/blocks/navigation-link/editor.css 473 B
build/block-library/blocks/navigation-link/style-rtl.css 94 B
build/block-library/blocks/navigation-link/style.css 94 B
build/block-library/blocks/navigation/editor-rtl.css 1.69 kB
build/block-library/blocks/navigation/editor.css 1.69 kB
build/block-library/blocks/navigation/style-rtl.css 1.65 kB
build/block-library/blocks/navigation/style.css 1.66 kB
build/block-library/blocks/navigation/view.min.js 2.87 kB
build/block-library/blocks/nextpage/editor-rtl.css 395 B
build/block-library/blocks/nextpage/editor.css 395 B
build/block-library/blocks/page-list/editor-rtl.css 310 B
build/block-library/blocks/page-list/editor.css 311 B
build/block-library/blocks/page-list/style-rtl.css 240 B
build/block-library/blocks/page-list/style.css 240 B
build/block-library/blocks/paragraph/editor-rtl.css 157 B
build/block-library/blocks/paragraph/editor.css 157 B
build/block-library/blocks/paragraph/style-rtl.css 247 B
build/block-library/blocks/paragraph/style.css 248 B
build/block-library/blocks/post-author/editor-rtl.css 209 B
build/block-library/blocks/post-author/editor.css 209 B
build/block-library/blocks/post-author/style-rtl.css 183 B
build/block-library/blocks/post-author/style.css 184 B
build/block-library/blocks/post-comments-form/style-rtl.css 140 B
build/block-library/blocks/post-comments-form/style.css 140 B
build/block-library/blocks/post-comments/style-rtl.css 360 B
build/block-library/blocks/post-comments/style.css 359 B
build/block-library/blocks/post-content/editor-rtl.css 139 B
build/block-library/blocks/post-content/editor.css 139 B
build/block-library/blocks/post-excerpt/editor-rtl.css 73 B
build/block-library/blocks/post-excerpt/editor.css 73 B
build/block-library/blocks/post-excerpt/style-rtl.css 69 B
build/block-library/blocks/post-excerpt/style.css 69 B
build/block-library/blocks/post-featured-image/editor-rtl.css 338 B
build/block-library/blocks/post-featured-image/editor.css 338 B
build/block-library/blocks/post-featured-image/style-rtl.css 141 B
build/block-library/blocks/post-featured-image/style.css 141 B
build/block-library/blocks/post-template/editor-rtl.css 100 B
build/block-library/blocks/post-template/editor.css 99 B
build/block-library/blocks/post-template/style-rtl.css 379 B
build/block-library/blocks/post-template/style.css 380 B
build/block-library/blocks/post-terms/style-rtl.css 73 B
build/block-library/blocks/post-terms/style.css 73 B
build/block-library/blocks/post-title/style-rtl.css 60 B
build/block-library/blocks/post-title/style.css 60 B
build/block-library/blocks/preformatted/style-rtl.css 103 B
build/block-library/blocks/preformatted/style.css 103 B
build/block-library/blocks/pullquote/editor-rtl.css 183 B
build/block-library/blocks/pullquote/editor.css 183 B
build/block-library/blocks/pullquote/style-rtl.css 318 B
build/block-library/blocks/pullquote/style.css 318 B
build/block-library/blocks/pullquote/theme-rtl.css 169 B
build/block-library/blocks/pullquote/theme.css 169 B
build/block-library/blocks/query-pagination-numbers/editor-rtl.css 122 B
build/block-library/blocks/query-pagination-numbers/editor.css 121 B
build/block-library/blocks/query-pagination/editor-rtl.css 270 B
build/block-library/blocks/query-pagination/editor.css 262 B
build/block-library/blocks/query-pagination/style-rtl.css 168 B
build/block-library/blocks/query-pagination/style.css 168 B
build/block-library/blocks/query-title/editor-rtl.css 86 B
build/block-library/blocks/query-title/editor.css 86 B
build/block-library/blocks/query/editor-rtl.css 131 B
build/block-library/blocks/query/editor.css 132 B
build/block-library/blocks/quote/style-rtl.css 169 B
build/block-library/blocks/quote/style.css 169 B
build/block-library/blocks/quote/theme-rtl.css 221 B
build/block-library/blocks/quote/theme.css 221 B
build/block-library/blocks/rss/editor-rtl.css 201 B
build/block-library/blocks/rss/editor.css 202 B
build/block-library/blocks/rss/style-rtl.css 290 B
build/block-library/blocks/rss/style.css 290 B
build/block-library/blocks/search/editor-rtl.css 211 B
build/block-library/blocks/search/editor.css 211 B
build/block-library/blocks/search/style-rtl.css 359 B
build/block-library/blocks/search/style.css 362 B
build/block-library/blocks/search/theme-rtl.css 64 B
build/block-library/blocks/search/theme.css 64 B
build/block-library/blocks/separator/editor-rtl.css 99 B
build/block-library/blocks/separator/editor.css 99 B
build/block-library/blocks/separator/style-rtl.css 251 B
build/block-library/blocks/separator/style.css 251 B
build/block-library/blocks/separator/theme-rtl.css 172 B
build/block-library/blocks/separator/theme.css 172 B
build/block-library/blocks/shortcode/editor-rtl.css 476 B
build/block-library/blocks/shortcode/editor.css 476 B
build/block-library/blocks/site-logo/editor-rtl.css 465 B
build/block-library/blocks/site-logo/editor.css 465 B
build/block-library/blocks/site-logo/style-rtl.css 154 B
build/block-library/blocks/site-logo/style.css 154 B
build/block-library/blocks/site-tagline/editor-rtl.css 87 B
build/block-library/blocks/site-tagline/editor.css 87 B
build/block-library/blocks/site-title/editor-rtl.css 85 B
build/block-library/blocks/site-title/editor.css 85 B
build/block-library/blocks/social-link/editor-rtl.css 164 B
build/block-library/blocks/social-link/editor.css 165 B
build/block-library/blocks/social-links/editor-rtl.css 800 B
build/block-library/blocks/social-links/editor.css 799 B
build/block-library/blocks/social-links/style-rtl.css 1.34 kB
build/block-library/blocks/social-links/style.css 1.34 kB
build/block-library/blocks/spacer/editor-rtl.css 308 B
build/block-library/blocks/spacer/editor.css 308 B
build/block-library/blocks/spacer/style-rtl.css 48 B
build/block-library/blocks/spacer/style.css 48 B
build/block-library/blocks/table/editor-rtl.css 478 B
build/block-library/blocks/table/editor.css 478 B
build/block-library/blocks/table/style-rtl.css 480 B
build/block-library/blocks/table/style.css 480 B
build/block-library/blocks/table/theme-rtl.css 188 B
build/block-library/blocks/table/theme.css 188 B
build/block-library/blocks/tag-cloud/style-rtl.css 146 B
build/block-library/blocks/tag-cloud/style.css 146 B
build/block-library/blocks/template-part/editor-rtl.css 551 B
build/block-library/blocks/template-part/editor.css 550 B
build/block-library/blocks/template-part/theme-rtl.css 101 B
build/block-library/blocks/template-part/theme.css 101 B
build/block-library/blocks/term-description/editor-rtl.css 90 B
build/block-library/blocks/term-description/editor.css 90 B
build/block-library/blocks/text-columns/editor-rtl.css 95 B
build/block-library/blocks/text-columns/editor.css 95 B
build/block-library/blocks/text-columns/style-rtl.css 166 B
build/block-library/blocks/text-columns/style.css 166 B
build/block-library/blocks/verse/style-rtl.css 87 B
build/block-library/blocks/verse/style.css 87 B
build/block-library/blocks/video/editor-rtl.css 569 B
build/block-library/blocks/video/editor.css 570 B
build/block-library/blocks/video/style-rtl.css 173 B
build/block-library/blocks/video/style.css 173 B
build/block-library/blocks/video/theme-rtl.css 124 B
build/block-library/blocks/video/theme.css 124 B
build/block-library/common-rtl.css 1.29 kB
build/block-library/common.css 1.29 kB
build/block-library/editor-rtl.css 9.81 kB
build/block-library/editor.css 9.81 kB
build/block-library/reset-rtl.css 514 B
build/block-library/reset.css 515 B
build/block-library/style-rtl.css 10.3 kB
build/block-library/style.css 10.3 kB
build/block-library/theme-rtl.css 692 B
build/block-library/theme.css 693 B
build/block-serialization-default-parser/index.min.js 1.3 kB
build/block-serialization-spec-parser/index.min.js 3.06 kB
build/customize-widgets/style-rtl.css 1.48 kB
build/customize-widgets/style.css 1.48 kB
build/date/index.min.js 31.8 kB
build/dom-ready/index.min.js 576 B
build/dom/index.min.js 4.78 kB
build/edit-navigation/style-rtl.css 3.12 kB
build/edit-navigation/style.css 3.12 kB
build/edit-post/classic-rtl.css 483 B
build/edit-post/classic.css 483 B
build/edit-post/style-rtl.css 7.25 kB
build/edit-post/style.css 7.24 kB
build/edit-site/style-rtl.css 5.04 kB
build/edit-site/style.css 5.03 kB
build/edit-widgets/style-rtl.css 3.88 kB
build/edit-widgets/style.css 3.89 kB
build/editor/style-rtl.css 3.88 kB
build/editor/style.css 3.88 kB
build/element/index.min.js 3.44 kB
build/escape-html/index.min.js 739 B
build/format-library/style-rtl.css 668 B
build/format-library/style.css 669 B
build/html-entities/index.min.js 628 B
build/is-shallow-equal/index.min.js 710 B
build/keycodes/index.min.js 1.43 kB
build/list-reusable-blocks/index.min.js 2.07 kB
build/list-reusable-blocks/style-rtl.css 842 B
build/list-reusable-blocks/style.css 842 B
build/notices/index.min.js 1.07 kB
build/nux/index.min.js 2.31 kB
build/nux/style-rtl.css 745 B
build/nux/style.css 742 B
build/plugins/index.min.js 1.99 kB
build/primitives/index.min.js 1.06 kB
build/react-i18n/index.min.js 924 B
build/redux-routine/index.min.js 2.82 kB
build/reusable-blocks/style-rtl.css 256 B
build/reusable-blocks/style.css 256 B
build/token-list/index.min.js 847 B
build/url/index.min.js 1.95 kB
build/viewport/index.min.js 1.28 kB
build/widgets/style-rtl.css 1.04 kB
build/widgets/style.css 1.05 kB
build/wordcount/index.min.js 1.24 kB

compressed-size-action

@sarayourfriend
Copy link
Contributor Author

I'm currently investating why VisuallyHidden's styles aren't being applied.

This seems like a bug in our StyleProvider implementation.

VisuallyHidden definitely has a StyleProvider as a grandparent in the React tree. Even still, the styles are not being applied to the iframe's head, only to the parent document's head. Some styles do get applied, I've noticed StyledSpinner getting applied, just not VisuallyHidden. There's nothing special about VisuallyHidden actually, and if I strip its styles down to nothing it still doesn't work, so it's not something with its particular styles.

Currently pretty stumped on this one.

@sarayourfriend sarayourfriend self-assigned this May 17, 2021
@sarayourfriend sarayourfriend added [Feature] Component System WordPress component system [Package] Components /packages/components labels May 17, 2021
@sarayourfriend
Copy link
Contributor Author

I've stumbled upon something interesting. It appears that css doesn't connect to the emotion cache correctly. But styled does. If I convert VisuallyHidden to just be a styled.div it works perfectly.

@sarayourfriend
Copy link
Contributor Author

sarayourfriend commented May 17, 2021

I can reproduce the above with this minimal example: https://codesandbox.io/s/rendering-emotion-iframe-into-body-forked-4dmmt?file=/src/index.js Never mind, I can't reproduce it, must have been a fluke.

I wonder what the issue is here? Seems like it could be a bug but we're on Emotion 10 so I'm not sure it's worth filing an issue for it. What do you think @youknowriad? Should we prioritize upgrading to Emotion 11 to see if it fixes this issue? I can't find anything about this online at all.

@youknowriad
Copy link
Contributor

What do you think @youknowriad? Should we prioritize upgrading to Emotion 11 to see if it fixes this issue?

That sounds like a good plan to me. Do you know how difficult would that be?

@sarayourfriend
Copy link
Contributor Author

#31476 is currently blocked by an issue with webpack (summarized in the PR)

@sarayourfriend
Copy link
Contributor Author

Okay after rebasing I've found that the Emotion 11 upgrade does not fix the issue we're seeing. What's more, I'm able to reproduce the issue in this codesandbox: https://codesandbox.io/s/relaxed-browser-4fe79?file=/src/App.js

It might be worth fiddling around with that codesandbox until we can isolate where the issue is coming from.

@sarayourfriend sarayourfriend force-pushed the revert-31882-revert/visually-hidden-component branch from c0f26f7 to 58b59d6 Compare June 28, 2021 16:19
@sarayourfriend
Copy link
Contributor Author

Okay, so per emotion-js/emotion#2409 we'll move just using styled and never importing css from @emotion/css so this PR now reflects that change (along with the differences in approach we'll have to take to accomplish that).

@sarayourfriend sarayourfriend requested a review from ciampo June 28, 2021 16:20
Copy link
Contributor

@ciampo ciampo left a comment

Choose a reason for hiding this comment

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

Overall code changes look good! I just left a few comments to clarify some aspects.

Also, should we also have a story with a Visually Hidden but focusable element?

Could you also rebase this PR in order to solve conflicts? Thank you!!

packages/components/src/visually-hidden/component.js Outdated Show resolved Hide resolved
packages/components/src/visually-hidden/hook.js Outdated Show resolved Hide resolved
packages/components/src/visually-hidden/component.js Outdated Show resolved Hide resolved
packages/components/src/visually-hidden/component.js Outdated Show resolved Hide resolved
@sarayourfriend
Copy link
Contributor Author

Also, should we also have a story with a Visually Hidden but focusable element?

I think the correct way to test this is to focus a piece of text using a screen reader. @diegohaz is that correct? I'm worried that adding a story with say, a visually hidden button would be misleading. Are we supposed to visually hide buttons or other similar elements like that?

@sarayourfriend sarayourfriend force-pushed the revert-31882-revert/visually-hidden-component branch from 651cf43 to 35892e1 Compare June 30, 2021 16:16
@ciampo
Copy link
Contributor

ciampo commented Jun 30, 2021

I think the correct way to test this is to focus a piece of text using a screen reader. @diegohaz is that correct? I'm worried that adding a story with say, a visually hidden button would be misleading. Are we supposed to visually hide buttons or other similar elements like that?

I think it would still make sense — an example that comes to mind for this use case is a "Skip to content" button.

The reason why I was proposing to add a story is that we have specific styles that will show the content of VisuallyHidden when the wrapping component is focused:

&:focus {
background-color: ${ COLORS.lightGray[ '300' ] };
clip: auto !important;
clip-path: none;
color: #444;
display: block;
font-size: 1em;
height: auto;
left: 5px;
line-height: normal;
padding: 15px 23px 14px;
text-decoration: none;
top: 5px;
width: auto;
z-index: 100000;

@sarayourfriend
Copy link
Contributor Author

Yeah for what it's worth you can test this in the browser by inspecting the element and forcing the focus pseudo class on it using the dev tools:

Captura de Tela 2021-06-30 às 10 20 26

@ciampo
Copy link
Contributor

ciampo commented Jun 30, 2021

you can test this in the browser

My point about adding a story was to illustrate to the users of this component an example for when those focus styles would come in handy — something like

<VisuallyHidden as="Button" variant="tertiary">Skip to content</VisuallyHidden>` 

Before approving, I'd also like to hear @diegohaz 's opinion around the way this component handles focus (see packages/components/src/visually-hidden/styles.js):

  • how to best test this part of the component?
  • is this a correct, comprehensive and accessible approach?
  • should we also add styles for other states like :active ?

@diegohaz
Copy link
Member

diegohaz commented Jul 8, 2021

Before approving, I'd also like to hear @diegohaz 's opinion around the way this component handles focus (see packages/components/src/visually-hidden/styles.js):

  • how to best test this part of the component?
  • is this a correct, comprehensive and accessible approach?
  • should we also add styles for other states like :active ?

Sorry for the delay. I missed this one in my notifications.

I don't think this component should be used as "skip to content" links. I'd only use this to hide things from sighted users (including keyboard users that would benefit from the "skip to content" link) while keeping them visible for screen readers. A common use case for this that we can add as a story is a Learn more link:

<p>
  In addition to SmartThings' own family of sensors, you can also control hundreds of connected devices from other brands through the SmartThings open platform.{ ' ' }
  <a href="#">Learn more<VisuallyHidden> about connected devices</VisuallyHidden></a>
</p>

That would be useful so screen reader users scanning links in the site would have more context other than a bunch of "Learn more" links.

Regarding "skip to content" links, these are the styles I've seen out there:

left: -999px;
position: absolute;
top: auto;
width: 1px;
height: 1px;
overflow: hidden;
z-index: -999;
&:focus,
&:active {
  background-color: white;
  left: auto;
  top: auto;
  height: auto;
  width: max-content;
  overflow: auto;
  padding: 1em;
  margin: 1em;
  text-align: center;
  z-index: 999;
}

@diegohaz
Copy link
Member

diegohaz commented Jul 8, 2021

If we remove the :focus/:active styles, would you think this component could just use inline styles?

@sarayourfriend
Copy link
Contributor Author

If we remove the :focus/:active styles, would you think this component could just use inline styles?

Yes!

@sarayourfriend sarayourfriend force-pushed the revert-31882-revert/visually-hidden-component branch 2 times, most recently from d95518e to 5c9628d Compare July 12, 2021 16:53
Copy link
Member

@diegohaz diegohaz left a comment

Choose a reason for hiding this comment

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

This looks good to me. Thank you for working on this @sarayourfriend! 🎉

@sarayourfriend sarayourfriend force-pushed the revert-31882-revert/visually-hidden-component branch from 411a324 to cfe4ba2 Compare July 16, 2021 15:50
@sarayourfriend sarayourfriend merged commit 2d99d85 into trunk Jul 17, 2021
@sarayourfriend sarayourfriend deleted the revert-31882-revert/visually-hidden-component branch July 17, 2021 00:41
@github-actions github-actions bot added this to the Gutenberg 11.2 milestone Jul 17, 2021
@gziolo
Copy link
Member

gziolo commented Aug 6, 2021

I'm not a big fan of this refactoring. Do we even need a component context system for visually hidden components? The whole point of VisuallyHidden component was to abstract the screen-reader-text class name that is used in WordPress as explained https://make.wordpress.org/accessibility/handbook/markup/the-css-class-screen-reader-text/. This PR removes the class name in the first place which might impact existing sites when they apply modifications to the same class. In addition to that, the proposed change removes CSS that brings focusable elements with .screen-reader-text into view when they receive keyboard focus – specifically targeted for skip links.

Related CSS for WP-Admin:

https://github.com/WordPress/wordpress-develop/blob/31a6cd2f781ebe12f2858fd389cd95dccb23cbd5/src/wp-admin/css/common.css#L120-L139

and

https://github.com/WordPress/wordpress-develop/blob/31a6cd2f781ebe12f2858fd389cd95dccb23cbd5/src/wp-admin/css/common.css#L289-L292

@gziolo
Copy link
Member

gziolo commented Aug 6, 2021

You can discard my previous comment 😅

I was wrong. It looks like the implementation was always only mirroring screen-reader-text class as can be seen in #18022. The confusion comes from the fact that we were replacing occurrences of screen-reader-text, example: #18165.

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
None yet
Development

Successfully merging this pull request may close these issues.

5 participants