[a11y][Page] Secondary actions should have an ability to receive focus

[tatianau]

Issue summary

There is a focus management issue prevalent across the Admin. Many of the Page secondary actions in the Admin - e.g. Import, Export, Duplicate, etc. - open a modal, and currently there is no easy way to return focus to the modal activator when the activator is the secondary action of the Page component that doesn't support it.

Expected behavior

Ability to connect Page secondary actions to the modal or any other overlay to be able to return focus to the activator.
For example, by adding the ability to provide an activatorRef to <Page />'s secondaryActions to then pass it to the <Modal /> as an activator.

Actual behavior

No ability to connect <Page />'s secondary actions to the overlay they open.

Steps to reproduce the problem

1. Open any section that has secondary actions that open a modal.
   1.1. Example actions: Export, Import, Duplicate.
   1.2. Example pages: Discount index, Product index, Product details, Variant details.
2. Use keyboard tab to navigate through the page
3. Activate the action to open a modal
4. Close modal or cancel out of it
5. See the focus returns to the top of the page instead of the modal activator

Product export modal focus

Export.modal.activator.focus.mp4

Relevant discussions and previous attempts to fix it

#8058, #5258, #5495, Shopify/web-configs#349

[tatianau]

@oksanashopify this might be an interesting issue to tackle / pair on with such a broad impact, also cc @jakemoves @stefanlegg @maxariss for context.

[oksanashopify]

Posting here just to keep an eye on ongoing conversation about
Consolidate "page actions" in Resource detail layout pattern

[knames]

#8701 will partially solve this. if a secondary action ends up in a rollup/popover, the popover is closed on click so there's nothing to return to. I attempted many times to solve this, but there's weirdness with items popping in and out of the More Actions, resizing issues (and overlapping titles).

[knames]

Here's a branch that has popover's that stay open when provided with id's and refs, should anyone want to try and run it the last mile

ks-popover-stay

[github-actions]

Hi! We noticed there hasn’t been activity on this issue in a while. After 30 days, it will close automatically.

If it’s still relevant, or you have updates, comment and let us know. And don’t worry, you can always re-open later if needed.