Skip to content

Fix Shift+Tab to Block Toolbar#52196

Closed
jeryj wants to merge 2 commits intotrunkfrom
fix/shift-tab
Closed

Fix Shift+Tab to Block Toolbar#52196
jeryj wants to merge 2 commits intotrunkfrom
fix/shift-tab

Conversation

@jeryj
Copy link
Copy Markdown
Contributor

@jeryj jeryj commented Jun 30, 2023

An attempt at fixing #51876. Very much in draft state! I don't even know if this is a good idea, but it was feeling like a good approach since it removed and simplified a lot of the code while also being more performant. I expect to find a lot of bugs with this along the way though :)

Notes:

  • I'll be out until July 6th, so anyone is free to take this over!
    -There would need to be some kind of deprecation/preserving the old NavigableToolbar initialIndex, onIndexChange, and focusOnMount behavior from before. Or, we could just leave it as is but not use it.

What?

Shift+tab to focus the toolbar stopped working with the upgrade to ariakit. Something changed about the render order where it is rendered too late to receive the focus from shift+tab.

Why?

How?

Instead of trying to get it to render sooner in the process, it seems better to leave it in the DOM and hide/show it via an old-school CSS move-it-way-off-frame method. Doing it this way gives us several advantages:

  • Fewer mounts/unmounts of the component
  • Simplifies the logic of preserving the index of moving focus into the toolbar. We don't need to rely on tracking and resetting the index between mounts since it never gets unmounted.

Testing Instructions

Testing Instructions for Keyboard

Screenshots or screencast

jeryj added 2 commits June 30, 2023 11:32
…e so we can use shift+tab to focus it.

Can't figure out why the toolbarRef isn't working
We're hiding the toolbar via position absolute so it CAN be focused, but just not visible. This allows the alt+f10 shortcut to work and also preserves the initial index without all of the unmounting and remounting stuff.
@github-actions
Copy link
Copy Markdown

Size Change: -193 B (0%)

Total Size: 1.42 MB

Filename Size Change
build/block-editor/index.min.js 209 kB -193 B (0%)
ℹ️ View Unchanged
Filename Size
build/a11y/index.min.js 955 B
build/annotations/index.min.js 2.69 kB
build/api-fetch/index.min.js 2.28 kB
build/autop/index.min.js 2.1 kB
build/blob/index.min.js 451 B
build/block-directory/index.min.js 6.99 kB
build/block-directory/style-rtl.css 1.02 kB
build/block-directory/style.css 1.02 kB
build/block-editor/content-rtl.css 4.25 kB
build/block-editor/content.css 4.24 kB
build/block-editor/default-editor-styles-rtl.css 381 B
build/block-editor/default-editor-styles.css 381 B
build/block-editor/style-rtl.css 14.6 kB
build/block-editor/style.css 14.6 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 90 B
build/block-library/blocks/archives/style.css 90 B
build/block-library/blocks/audio/editor-rtl.css 150 B
build/block-library/blocks/audio/editor.css 150 B
build/block-library/blocks/audio/style-rtl.css 122 B
build/block-library/blocks/audio/style.css 122 B
build/block-library/blocks/audio/theme-rtl.css 126 B
build/block-library/blocks/audio/theme.css 126 B
build/block-library/blocks/avatar/editor-rtl.css 116 B
build/block-library/blocks/avatar/editor.css 116 B
build/block-library/blocks/avatar/style-rtl.css 104 B
build/block-library/blocks/avatar/style.css 104 B
build/block-library/blocks/block/editor-rtl.css 305 B
build/block-library/blocks/block/editor.css 305 B
build/block-library/blocks/button/editor-rtl.css 584 B
build/block-library/blocks/button/editor.css 582 B
build/block-library/blocks/button/style-rtl.css 624 B
build/block-library/blocks/button/style.css 623 B
build/block-library/blocks/buttons/editor-rtl.css 337 B
build/block-library/blocks/buttons/editor.css 337 B
build/block-library/blocks/buttons/style-rtl.css 332 B
build/block-library/blocks/buttons/style.css 332 B
build/block-library/blocks/calendar/style-rtl.css 239 B
build/block-library/blocks/calendar/style.css 239 B
build/block-library/blocks/categories/editor-rtl.css 113 B
build/block-library/blocks/categories/editor.css 112 B
build/block-library/blocks/categories/style-rtl.css 124 B
build/block-library/blocks/categories/style.css 124 B
build/block-library/blocks/code/editor-rtl.css 53 B
build/block-library/blocks/code/editor.css 53 B
build/block-library/blocks/code/style-rtl.css 121 B
build/block-library/blocks/code/style.css 121 B
build/block-library/blocks/code/theme-rtl.css 124 B
build/block-library/blocks/code/theme.css 124 B
build/block-library/blocks/columns/editor-rtl.css 108 B
build/block-library/blocks/columns/editor.css 108 B
build/block-library/blocks/columns/style-rtl.css 409 B
build/block-library/blocks/columns/style.css 409 B
build/block-library/blocks/comment-author-avatar/editor-rtl.css 125 B
build/block-library/blocks/comment-author-avatar/editor.css 125 B
build/block-library/blocks/comment-content/style-rtl.css 92 B
build/block-library/blocks/comment-content/style.css 92 B
build/block-library/blocks/comment-template/style-rtl.css 199 B
build/block-library/blocks/comment-template/style.css 198 B
build/block-library/blocks/comments-pagination-numbers/editor-rtl.css 123 B
build/block-library/blocks/comments-pagination-numbers/editor.css 121 B
build/block-library/blocks/comments-pagination/editor-rtl.css 222 B
build/block-library/blocks/comments-pagination/editor.css 209 B
build/block-library/blocks/comments-pagination/style-rtl.css 235 B
build/block-library/blocks/comments-pagination/style.css 231 B
build/block-library/blocks/comments-title/editor-rtl.css 75 B
build/block-library/blocks/comments-title/editor.css 75 B
build/block-library/blocks/comments/editor-rtl.css 840 B
build/block-library/blocks/comments/editor.css 839 B
build/block-library/blocks/comments/style-rtl.css 637 B
build/block-library/blocks/comments/style.css 636 B
build/block-library/blocks/cover/editor-rtl.css 647 B
build/block-library/blocks/cover/editor.css 650 B
build/block-library/blocks/cover/style-rtl.css 1.61 kB
build/block-library/blocks/cover/style.css 1.6 kB
build/block-library/blocks/details/editor-rtl.css 65 B
build/block-library/blocks/details/editor.css 65 B
build/block-library/blocks/details/style-rtl.css 159 B
build/block-library/blocks/details/style.css 159 B
build/block-library/blocks/embed/editor-rtl.css 293 B
build/block-library/blocks/embed/editor.css 293 B
build/block-library/blocks/embed/style-rtl.css 410 B
build/block-library/blocks/embed/style.css 410 B
build/block-library/blocks/embed/theme-rtl.css 126 B
build/block-library/blocks/embed/theme.css 126 B
build/block-library/blocks/file/editor-rtl.css 316 B
build/block-library/blocks/file/editor.css 316 B
build/block-library/blocks/file/style-rtl.css 269 B
build/block-library/blocks/file/style.css 270 B
build/block-library/blocks/file/view.min.js 312 B
build/block-library/blocks/footnotes/style-rtl.css 191 B
build/block-library/blocks/footnotes/style.css 188 B
build/block-library/blocks/freeform/editor-rtl.css 2.58 kB
build/block-library/blocks/freeform/editor.css 2.58 kB
build/block-library/blocks/gallery/editor-rtl.css 947 B
build/block-library/blocks/gallery/editor.css 952 B
build/block-library/blocks/gallery/style-rtl.css 1.53 kB
build/block-library/blocks/gallery/style.css 1.53 kB
build/block-library/blocks/gallery/theme-rtl.css 108 B
build/block-library/blocks/gallery/theme.css 108 B
build/block-library/blocks/group/editor-rtl.css 654 B
build/block-library/blocks/group/editor.css 654 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 78 B
build/block-library/blocks/group/theme.css 78 B
build/block-library/blocks/heading/style-rtl.css 76 B
build/block-library/blocks/heading/style.css 76 B
build/block-library/blocks/html/editor-rtl.css 336 B
build/block-library/blocks/html/editor.css 337 B
build/block-library/blocks/image/editor-rtl.css 834 B
build/block-library/blocks/image/editor.css 833 B
build/block-library/blocks/image/style-rtl.css 1.42 kB
build/block-library/blocks/image/style.css 1.42 kB
build/block-library/blocks/image/theme-rtl.css 126 B
build/block-library/blocks/image/theme.css 126 B
build/block-library/blocks/image/view-interactivity.min.js 1.46 kB
build/block-library/blocks/latest-comments/style-rtl.css 357 B
build/block-library/blocks/latest-comments/style.css 357 B
build/block-library/blocks/latest-posts/editor-rtl.css 213 B
build/block-library/blocks/latest-posts/editor.css 212 B
build/block-library/blocks/latest-posts/style-rtl.css 478 B
build/block-library/blocks/latest-posts/style.css 478 B
build/block-library/blocks/list/style-rtl.css 88 B
build/block-library/blocks/list/style.css 88 B
build/block-library/blocks/media-text/editor-rtl.css 266 B
build/block-library/blocks/media-text/editor.css 263 B
build/block-library/blocks/media-text/style-rtl.css 507 B
build/block-library/blocks/media-text/style.css 505 B
build/block-library/blocks/more/editor-rtl.css 431 B
build/block-library/blocks/more/editor.css 431 B
build/block-library/blocks/navigation-link/editor-rtl.css 712 B
build/block-library/blocks/navigation-link/editor.css 711 B
build/block-library/blocks/navigation-link/style-rtl.css 115 B
build/block-library/blocks/navigation-link/style.css 115 B
build/block-library/blocks/navigation-submenu/editor-rtl.css 296 B
build/block-library/blocks/navigation-submenu/editor.css 295 B
build/block-library/blocks/navigation/editor-rtl.css 2.26 kB
build/block-library/blocks/navigation/editor.css 2.26 kB
build/block-library/blocks/navigation/style-rtl.css 2.21 kB
build/block-library/blocks/navigation/style.css 2.2 kB
build/block-library/blocks/navigation/view.min.js 906 B
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 401 B
build/block-library/blocks/page-list/editor.css 401 B
build/block-library/blocks/page-list/style-rtl.css 175 B
build/block-library/blocks/page-list/style.css 175 B
build/block-library/blocks/paragraph/editor-rtl.css 174 B
build/block-library/blocks/paragraph/editor.css 174 B
build/block-library/blocks/paragraph/style-rtl.css 279 B
build/block-library/blocks/paragraph/style.css 281 B
build/block-library/blocks/post-author/style-rtl.css 175 B
build/block-library/blocks/post-author/style.css 176 B
build/block-library/blocks/post-comments-form/editor-rtl.css 96 B
build/block-library/blocks/post-comments-form/editor.css 96 B
build/block-library/blocks/post-comments-form/style-rtl.css 508 B
build/block-library/blocks/post-comments-form/style.css 508 B
build/block-library/blocks/post-date/style-rtl.css 61 B
build/block-library/blocks/post-date/style.css 61 B
build/block-library/blocks/post-excerpt/editor-rtl.css 71 B
build/block-library/blocks/post-excerpt/editor.css 71 B
build/block-library/blocks/post-excerpt/style-rtl.css 141 B
build/block-library/blocks/post-excerpt/style.css 141 B
build/block-library/blocks/post-featured-image/editor-rtl.css 588 B
build/block-library/blocks/post-featured-image/editor.css 586 B
build/block-library/blocks/post-featured-image/style-rtl.css 319 B
build/block-library/blocks/post-featured-image/style.css 319 B
build/block-library/blocks/post-navigation-link/style-rtl.css 153 B
build/block-library/blocks/post-navigation-link/style.css 153 B
build/block-library/blocks/post-template/editor-rtl.css 99 B
build/block-library/blocks/post-template/editor.css 98 B
build/block-library/blocks/post-template/style-rtl.css 314 B
build/block-library/blocks/post-template/style.css 314 B
build/block-library/blocks/post-terms/style-rtl.css 96 B
build/block-library/blocks/post-terms/style.css 96 B
build/block-library/blocks/post-time-to-read/style-rtl.css 69 B
build/block-library/blocks/post-time-to-read/style.css 69 B
build/block-library/blocks/post-title/style-rtl.css 100 B
build/block-library/blocks/post-title/style.css 100 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 135 B
build/block-library/blocks/pullquote/editor.css 135 B
build/block-library/blocks/pullquote/style-rtl.css 335 B
build/block-library/blocks/pullquote/style.css 335 B
build/block-library/blocks/pullquote/theme-rtl.css 167 B
build/block-library/blocks/pullquote/theme.css 167 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 221 B
build/block-library/blocks/query-pagination/editor.css 211 B
build/block-library/blocks/query-pagination/style-rtl.css 288 B
build/block-library/blocks/query-pagination/style.css 284 B
build/block-library/blocks/query-title/style-rtl.css 63 B
build/block-library/blocks/query-title/style.css 63 B
build/block-library/blocks/query/editor-rtl.css 450 B
build/block-library/blocks/query/editor.css 449 B
build/block-library/blocks/quote/style-rtl.css 222 B
build/block-library/blocks/quote/style.css 222 B
build/block-library/blocks/quote/theme-rtl.css 223 B
build/block-library/blocks/quote/theme.css 226 B
build/block-library/blocks/read-more/style-rtl.css 132 B
build/block-library/blocks/read-more/style.css 132 B
build/block-library/blocks/rss/editor-rtl.css 149 B
build/block-library/blocks/rss/editor.css 149 B
build/block-library/blocks/rss/style-rtl.css 289 B
build/block-library/blocks/rss/style.css 288 B
build/block-library/blocks/search/editor-rtl.css 178 B
build/block-library/blocks/search/editor.css 178 B
build/block-library/blocks/search/style-rtl.css 587 B
build/block-library/blocks/search/style.css 584 B
build/block-library/blocks/search/theme-rtl.css 114 B
build/block-library/blocks/search/theme.css 114 B
build/block-library/blocks/search/view.min.js 531 B
build/block-library/blocks/separator/editor-rtl.css 146 B
build/block-library/blocks/separator/editor.css 146 B
build/block-library/blocks/separator/style-rtl.css 234 B
build/block-library/blocks/separator/style.css 234 B
build/block-library/blocks/separator/theme-rtl.css 194 B
build/block-library/blocks/separator/theme.css 194 B
build/block-library/blocks/shortcode/editor-rtl.css 323 B
build/block-library/blocks/shortcode/editor.css 323 B
build/block-library/blocks/site-logo/editor-rtl.css 754 B
build/block-library/blocks/site-logo/editor.css 754 B
build/block-library/blocks/site-logo/style-rtl.css 203 B
build/block-library/blocks/site-logo/style.css 203 B
build/block-library/blocks/site-tagline/editor-rtl.css 86 B
build/block-library/blocks/site-tagline/editor.css 86 B
build/block-library/blocks/site-title/editor-rtl.css 116 B
build/block-library/blocks/site-title/editor.css 116 B
build/block-library/blocks/site-title/style-rtl.css 57 B
build/block-library/blocks/site-title/style.css 57 B
build/block-library/blocks/social-link/editor-rtl.css 184 B
build/block-library/blocks/social-link/editor.css 184 B
build/block-library/blocks/social-links/editor-rtl.css 674 B
build/block-library/blocks/social-links/editor.css 673 B
build/block-library/blocks/social-links/style-rtl.css 1.43 kB
build/block-library/blocks/social-links/style.css 1.42 kB
build/block-library/blocks/spacer/editor-rtl.css 348 B
build/block-library/blocks/spacer/editor.css 348 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 433 B
build/block-library/blocks/table/editor.css 433 B
build/block-library/blocks/table/style-rtl.css 645 B
build/block-library/blocks/table/style.css 644 B
build/block-library/blocks/table/theme-rtl.css 146 B
build/block-library/blocks/table/theme.css 146 B
build/block-library/blocks/tag-cloud/style-rtl.css 251 B
build/block-library/blocks/tag-cloud/style.css 253 B
build/block-library/blocks/template-part/editor-rtl.css 403 B
build/block-library/blocks/template-part/editor.css 403 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/style-rtl.css 111 B
build/block-library/blocks/term-description/style.css 111 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 99 B
build/block-library/blocks/verse/style.css 99 B
build/block-library/blocks/video/editor-rtl.css 552 B
build/block-library/blocks/video/editor.css 555 B
build/block-library/blocks/video/style-rtl.css 174 B
build/block-library/blocks/video/style.css 174 B
build/block-library/blocks/video/theme-rtl.css 126 B
build/block-library/blocks/video/theme.css 126 B
build/block-library/classic-rtl.css 179 B
build/block-library/classic.css 179 B
build/block-library/common-rtl.css 1.1 kB
build/block-library/common.css 1.1 kB
build/block-library/editor-elements-rtl.css 75 B
build/block-library/editor-elements.css 75 B
build/block-library/editor-rtl.css 12.1 kB
build/block-library/editor.css 12.1 kB
build/block-library/elements-rtl.css 54 B
build/block-library/elements.css 54 B
build/block-library/index.min.js 201 kB
build/block-library/reset-rtl.css 478 B
build/block-library/reset.css 478 B
build/block-library/style-rtl.css 13.7 kB
build/block-library/style.css 13.7 kB
build/block-library/theme-rtl.css 686 B
build/block-library/theme.css 691 B
build/block-serialization-default-parser/index.min.js 1.12 kB
build/block-serialization-spec-parser/index.min.js 2.87 kB
build/blocks/index.min.js 51 kB
build/commands/index.min.js 14.9 kB
build/commands/style-rtl.css 827 B
build/commands/style.css 827 B
build/components/index.min.js 240 kB
build/components/style-rtl.css 11.8 kB
build/components/style.css 11.8 kB
build/compose/index.min.js 12 kB
build/core-commands/index.min.js 2.26 kB
build/core-data/index.min.js 16.1 kB
build/customize-widgets/index.min.js 12 kB
build/customize-widgets/style-rtl.css 1.46 kB
build/customize-widgets/style.css 1.45 kB
build/data-controls/index.min.js 640 B
build/data/index.min.js 8.27 kB
build/date/index.min.js 17.8 kB
build/deprecated/index.min.js 451 B
build/dom-ready/index.min.js 324 B
build/dom/index.min.js 4.63 kB
build/edit-post/classic-rtl.css 544 B
build/edit-post/classic.css 545 B
build/edit-post/index.min.js 35.2 kB
build/edit-post/style-rtl.css 7.58 kB
build/edit-post/style.css 7.57 kB
build/edit-site/index.min.js 84.7 kB
build/edit-site/style-rtl.css 12.6 kB
build/edit-site/style.css 12.6 kB
build/edit-widgets/index.min.js 16.9 kB
build/edit-widgets/style-rtl.css 4.53 kB
build/edit-widgets/style.css 4.53 kB
build/editor/index.min.js 45.4 kB
build/editor/style-rtl.css 3.58 kB
build/editor/style.css 3.58 kB
build/element/index.min.js 4.8 kB
build/escape-html/index.min.js 537 B
build/format-library/index.min.js 7.62 kB
build/format-library/style-rtl.css 554 B
build/format-library/style.css 553 B
build/hooks/index.min.js 1.55 kB
build/html-entities/index.min.js 448 B
build/i18n/index.min.js 3.58 kB
build/interactivity/index.min.js 10 kB
build/is-shallow-equal/index.min.js 527 B
build/keyboard-shortcuts/index.min.js 1.64 kB
build/keycodes/index.min.js 1.84 kB
build/list-reusable-blocks/index.min.js 2.13 kB
build/list-reusable-blocks/style-rtl.css 836 B
build/list-reusable-blocks/style.css 836 B
build/media-utils/index.min.js 2.9 kB
build/notices/index.min.js 948 B
build/plugins/index.min.js 1.77 kB
build/preferences-persistence/index.min.js 1.84 kB
build/preferences/index.min.js 1.24 kB
build/primitives/index.min.js 943 B
build/priority-queue/index.min.js 1.52 kB
build/private-apis/index.min.js 943 B
build/react-i18n/index.min.js 615 B
build/react-refresh-entry/index.min.js 8.44 kB
build/react-refresh-runtime/index.min.js 7.31 kB
build/redux-routine/index.min.js 2.7 kB
build/reusable-blocks/index.min.js 2.39 kB
build/reusable-blocks/style-rtl.css 243 B
build/reusable-blocks/style.css 243 B
build/rich-text/index.min.js 10.9 kB
build/router/index.min.js 1.77 kB
build/server-side-render/index.min.js 1.94 kB
build/shortcode/index.min.js 1.39 kB
build/style-engine/index.min.js 1.83 kB
build/token-list/index.min.js 582 B
build/url/index.min.js 3.57 kB
build/vendors/inert-polyfill.min.js 2.48 kB
build/vendors/react-dom.min.js 41.8 kB
build/vendors/react.min.js 4.02 kB
build/viewport/index.min.js 958 B
build/warning/index.min.js 268 B
build/widgets/index.min.js 7.16 kB
build/widgets/style-rtl.css 1.15 kB
build/widgets/style.css 1.16 kB
build/wordcount/index.min.js 1.02 kB

compressed-size-action

@github-actions
Copy link
Copy Markdown

Flaky tests detected in 9819c41.
Some tests passed with failed attempts. The failures may not be related to this commit but are still reported for visibility. See the documentation for more information.

🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/5427134294
📝 Reported issues:

@diegohaz
Copy link
Copy Markdown
Member

diegohaz commented Jul 2, 2023

It's possible that this has been fixed in @ariakit/react@0.2.12. I made a change on ariakit/ariakit#2601 that was related to a different issue but may also impact this one.

@t-hamano
Copy link
Copy Markdown
Contributor

t-hamano commented Jul 7, 2023

@diegohaz

Thanks for the update! But I've updated the package and tested it locally, and it doesn't seem to solve this problem 😅

@alexstine
Copy link
Copy Markdown
Contributor

I noticed this bug in trunk but couldn't figure out where it came from. Once it does mount, tab will place you in it but after a shift+tab to Options button.

@diegohaz
Copy link
Copy Markdown
Member

diegohaz commented Jul 7, 2023

@diegohaz

Thanks for the update! But I've updated the package and tested it locally, and it doesn't seem to solve this problem 😅

Oh, thanks for testing! That was my best guess since I couldn't really find any other big difference between Reakit and Ariakit that could've impacted this behavior.

Just to be sure: did you follow the Updating Existing Dependencies guide to update the package?

@t-hamano
Copy link
Copy Markdown
Contributor

t-hamano commented Jul 7, 2023

Just to be sure: did you follow the Updating Existing Dependencies guide to update the package?

Oh, I had missed this page. I simply tested the following steps:

  • Manually change the subpackage version here
  • Run npm install in the project root

I assumed it was updated correctly because I saw the following diffs:

diff --git a/package-lock.json b/package-lock.json
index f9e56d0a6b..6b2f4d5f33 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -17418,7 +17418,7 @@
                "@wordpress/components": {
                        "version": "file:packages/components",
                        "requires": {
-                               "@ariakit/react": "^0.2.10",
+                               "@ariakit/react": "^0.2.12",
                                "@babel/runtime": "^7.16.0",
                                "@emotion/cache": "^11.7.1",
                                "@emotion/css": "^11.7.1",
diff --git a/packages/components/package.json b/packages/components/package.json
index 74220c1101..455d3daa3c 100644
--- a/packages/components/package.json
+++ b/packages/components/package.json
@@ -30,7 +30,7 @@
        ],
        "types": "build-types",
        "dependencies": {
-               "@ariakit/react": "^0.2.10",
+               "@ariakit/react": "^0.2.12",
                "@babel/runtime": "^7.16.0",
                "@emotion/cache": "^11.7.1",
                "@emotion/css": "^11.7.1",

I will test again later according to the documentation procedure.

@tellthemachines
Copy link
Copy Markdown
Contributor

Hi folks, what's the status of this PR? Is it being actively worked on? Asking because I notice the linked issue is tagged high priority, is in the 6.3 release board, and RC1 is scheduled for next week. Any chance we can get this fixed beforehand?

@jeryj
Copy link
Copy Markdown
Contributor Author

jeryj commented Jul 13, 2023

This isn't actively being worked on, as we're unsure it's even a good idea. It was more of an exploration to see if it was even possible. We can definitely pick it back up, but because it's such a large change in the behavior, it's unlikely to be more stable than reverting to reakit.

Before we put more time into this, we should figure out:

  • Why the upgrade broke the shift+tab behavior (is it caused by a bug with the implementation of ariakit in gutenberg, or a bug within ariakit?)
  • If the delayed rendering is caused by ariakit, is it a bug or a feature over reakit? For example, is it somehow far more performant and something we should implement?

The shift + tab behavior in the editor has been debated before. Is this a moment we should use to reconsider the behavior of navigating between toolbars?

I know this comment raises a lot more questions than it answers, but I think it'll be useful to figure these out so we can choose the best direction.

@alexstine
Copy link
Copy Markdown
Contributor

@jeryj I would be in favor of dropping Shift+Tab for toolbar since we have Alt+F10. This is a very common shortcut on Windows, F10, so Alt does not make it a very big ask. All the Microsoft Office products use F10 for ribbon navigation.

@jeryj
Copy link
Copy Markdown
Contributor Author

jeryj commented Jul 13, 2023

@alexstine I was looking at that behavior in other editors too. Two questions for implementing that behavior:

  1. Is there a common shortcut for returning from the toolbar? If you arrive at the toolbar using alt+f10, should an escape keypress return you to the block as long as you're still within the block toolbar?
  2. Since we have multiple toolbars, should alt+f10 cycle you through the available toolbars for that block?

@diegohaz
Copy link
Copy Markdown
Member

Looks like the regression is fixed by upgrading ariakit to v0.2.12. I'll open a PR.

@jeryj
Copy link
Copy Markdown
Contributor Author

jeryj commented Jul 13, 2023

Looks like the regression is fixed by upgrading ariakit to v0.2.12. I'll open a PR.

That's great! Thanks @diegohaz! I tried this earlier today but it wasn't working for me. It's 100% possible I was doing the upgrade path wrong. I tried:

  • removing ariakit from package.json and components/package.json
  • reinstalling all packages
  • Adding ariakit 0.2.12 back in.
  • reinstalling all packages again

@stokesman
Copy link
Copy Markdown
Contributor

Regardless of other considerations, I think this is a great exploration. There does seem to be some advantage to be had. Is there even a tradeoff? I.e. what is gained by removing the toolbar from the DOM?

@jeryj
Copy link
Copy Markdown
Contributor Author

jeryj commented Jul 13, 2023

@stokesman - I agree that having it rendered once but offscreen is a better solution overall, provided it works as expected everywhere. I wasn't sure if it was opening a can of worms of potential bugs though.

@alexstine
Copy link
Copy Markdown
Contributor

@jeryj Answers.

  1. Is there a common shortcut for returning from the toolbar? If you arrive at the toolbar using alt+f10, should an escape keypress return you to the block as long as you're still within the block toolbar?

Yes. Although, we'd probably have to change blocks such as navigation to have role="application" so we do not force Windows screen readers to switch modes on escape key press. This would need testing. This would work fine for Mac but pressing escape could cause Windows screen readers to switch into virtual mode which would mean we'd have little control over focus.

  1. Since we have multiple toolbars, should alt+f10 cycle you through the available toolbars for that block?

Probably so. This practice should have never happened in the first place. It is confusing without vision. If it is going to happen, tabs should be used to section the toolbars. Yet another oversight from lack of accessibility involvement from the start.

@jeryj
Copy link
Copy Markdown
Contributor Author

jeryj commented Jul 14, 2023

@alexstine

If it is going to happen, tabs should be used to section the toolbars.

So, ideally, there'd be one toolbar on the page, and using tab would move you between the toolbars?

For example, if you're on a caption in an image block you now have three toolbars in different parts of the DOM:

  • Caption toolbar
  • Image toolbar
  • Document toolbar

If we were able to position them together in the DOM, one alt+f10 press could bring you to the caption toolbar, then you could use shift+tab to reach the higher level toolbars? Or would it drop you to the start of the toolbar and you could press Tab 2x to reach the caption toolbar?

@alexstine
Copy link
Copy Markdown
Contributor

@jeryj No, I mean actual TabPanel implementation. It should be presented as an actual ribbon because in it's current state, there is no way for a non-sighted user to know there are multiple toolbars. For example, Alt+F10 should move you to the closest toolbar then you can press Shift+Tab in to the TabPanel to select another toolbar. Using your example:

  1. Alt+F10 would focus the caption toolbar since that would be the closest.
  2. Shift+Tab to the TabPanel would land you on Caption tab.
  3. Press Right or Left Arrow key to focus Image tab and press Enter.
  4. Press Tab to enter the Image toolbar.

The problem becomes communicating to users that there are multiple toolbars in the first place. If you had no vision, what indication is there currently to tell you multiple toolbars exist? None.

Shift+Tab and Tab should be restricted to the current block and should not allow you to change context. For example, you should not be able to Shift+Tab from the image toolbar into the top toolbar as the top toolbar is global, you cannot take action on the selected block from there. We always have landmark navigation to reach other regions of the editor.

Checkout Microsoft Word for inspiration. I give Microsoft a lot of trash for having some terrible products, Teams being one of them, but the Office suite is solid, works very well and always has.

Gutenberg does not work well for screen reader users because there are too many implied visuals. Need to figure out how to change that.

Thanks.

@johnbillion johnbillion deleted the fix/shift-tab branch February 10, 2025 16:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants