department-of-veterans-affairs / va.gov-team

Public resources for building on and in support of VA.gov. Visit complete Knowledge Hub:
https://depo-platform-documentation.scrollhelp.site/index.html
283 stars 204 forks source link

Staging Review finding: Include `aria-modal` attribute for sign in modal #94526

Open shiragoodman opened 1 month ago

shiragoodman commented 1 month ago

Need help? Please review how to read a Staging Review ticket. Tag @platform-governance-team-members on Slack if you need further assistance.

Product Information

Team: Identity Product: Sign in page (and sign in modal) Feature: Sign in Transition

Findings details

VA.gov Experience Standard - issue: User can't identify an element or its state. VA.gov Experience Standard - category: Usability Launch-blocking: No Design System review: No Collab Cycle Reviewer: @briandeconinck (Accessibility)

Description

The sign in modal is structured a little differently than the va-modal component. For the most part I think those differences make sense, but one easy improvement would be to include the aria-modal="true" attribute on the #signin-signup-modal element.

aria-modal helps communicate information about the state of the page to screen reader users. It's not strictly necessary to complete the interaction, but it helps to clarify the nature of the interaction to users who don't get any visual cues to indicate the modal behavior.

Recommended action

Add aria-modal="true" to the #signin-signup-modal element.

References


Next Steps for the VFS Team

claytonzook commented 3 weeks ago

Not doing this work before launch. For some add'l context, see this slack thread

shiragoodman commented 2 weeks ago

thanks @claytonzook . No worries about not addressing before launch, however I'm reopening this ticket because it is still an issue that needs to be addressed. We ask that VFS teams only close out the Staging Review finding tickets once the issue has been resolved. If you'd like to discuss further, please let me know.