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 205 forks source link

508-defect-2, sitewide [SCREENREADER, WIZARD] when tabbing through the wizard, screen readers read questions inconsistently #21078

Open AngelaFowler82 opened 3 years ago

AngelaFowler82 commented 3 years ago

Label: 14458

- [508-defect-2](https://github.com/department-of-veterans-affairs/va.gov-team/blob/master/platform/accessibility/guidance/defect-severity-rubric.md#508-defect-2)

Issue Title: Introduction: when tabbing through the form, screen readers read questions inconsistently.

Point of Contact: Angela Fowler

VFS Point of Contact: _First name only: Angela

User Story or Problem Statement:

When tabbing through a form, I expect my screen reader to read the questions prior to the answer which has focus, and to accurately follow keyboard focus as I tab between questions.

Details

When tabbing to the question: "Is this claim going through the legacy appeals process," In all environments except JAWS and Firefox, JAWS reads the question when focus is on the "Legacy Appeals Process" link. When the user tabs to the radio buttons, JAWS simply says "no." In Firefox with JAWS: the Legacy Appeals Process link does not appear and focus stays on the first set of radio buttons until the user tabs again. In all cases the user exits and reenters forms mode between questions, decreasing efficiency. These factors cause confusion as to what is being clicked on and could cause the user to click on the wrong element.

Acceptance Criteria

Environment

Steps to Recreate Using JAWS or NVDA, Access

https://staging.va.gov/decision-reviews/higher-level-review/request-higher-level-review-form-20-0996/introduction

Navigate to the level 1 heading "Request a Higher Level Review," From there you can tab through the form. Proposed Solution (if known)

WCAG or Vendor Guidance (optional)

Screenshots or Trace Logs

joshkimux commented 1 year ago

I wasn't able to replicate this issue within the wizard. @Mottie do you know if the question "Is this claim going through the legacy appeals process" still exists in the HLR "is this the form I need" wizard?

If it no longer exists, we can bump this down to a defect-3 or 4 as we'll still likely want to update this to match what we have in supplemental claims

Mottie commented 1 year ago

I just opened up a ticket yesterday to replace the HLR wizard with a subtask. We need some design and content updates, so it should get done in the near future. Thanks for following up on this, I totally forgot about this ticket.

cc: @eileen-coforma @saderagsdale

joshkimux commented 1 year ago

@Mottie how are you always like 5 steps ahead of me, truly the a11y 🐐 In the meantime, going to mark this as blocked awaiting completion on that ticket you opened up