Drawer: allow a custom element to be focused on close

[ChrisLaneAU]

This PR adds the ability for the Drawer to return focus to a custom element while maintaining the fallback of the existing trigger element. It also establishes a focusAll prop (naming was derived from the similarly behaving focus prop) on the Box component that is used by the two alert components.

The combination of these changes allows consumers to return focus to an alert, for example when a file upload in a drawer throws an error and we render the error style alert.

View preview

Checklist

Preflight

• Prefix the PR title with the slug of the package or component - e.g. accordion: Updated padding or docs: Updated header links
• Describe the changes clearly in the PR description
• Read and check your code before tagging someone for review
• Create a changeset file by running yarn changeset. Learn more about change management.

Testing

• Manually test component in various modern browsers at various sizes (use Browserstack)
• Manually test component in various devices (phone, tablet, desktop)
• Manually test component using a keyboard
• Manually test component using a screen reader
• Manually tested in dark mode
• Component meets Web Content Accessibility Guidelines (WCAG) 2.1 standards
• Add any necessary unit tests (HTML validation, snapshots etc)
• Run yarn test to ensure tests are passing. If required, run yarn test -u to update any generated snapshots.

Documentation

• Create or update documentation on the website
• Create or update stories for Storybook
• Create or update stories for Playroom snippets

[changeset-bot]

🦋 Changeset detected

Latest commit: d65f498

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@ag.ds-next/react	Minor

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]

PR Preview Action v1.4.7
Preview removed because the pull request was closed.
2024-05-10 04:08 UTC

[sonarqubecloud]

Quality Gate passed

Issues
2 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarCloud