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
281 stars 202 forks source link

[Consistency] User encounters a component or pattern that isn't considered a best practice. #80105

Open shiragoodman opened 6 months ago

shiragoodman commented 6 months ago

This ticket was generated during the pilot process for the new VA.gov experience standards. Please tag @platform-governance-team-members on Slack if you need assistance interpreting this ticket.

Product Information

Team: Benefits Non-Disability Product: Burial Form 530 Feature: 21P-530 Parity Updates

Findings details

VA.gov Experience Standard - issue: User encounters a component or pattern that isn't considered a best practice. VA.gov Experience Standard - category: Consistency Launch-blocking: No Design System review: No Collab Cycle Reviewer: @briandeconinck (Accessibility)

Description

In v2 /veteran-information/locaation-of-death/, conditionally revealed inputs don't follow guidance from the design system.

For the question "Where did the Veteran's death occur?" five of the six radio buttons result in new fields being revealed, and four of them reveal two fields each. Current design system guidance says no more than one new field can be revealed in an interaction.

The reasoning behind this: As a screen reader user moves through the page, there's no concept of the revealed fields being "children" of the original field, ie. nothing like the blue vertical line used to suggest that relationship to sighted users. If a screen reader user selects a radio button, begins filling in their responses to the revealed fields, then backtracks and changes their answer, they may not realize that the structure of the page will change when they head back down the page again. Limiting to one revealed field limits how much they need to parse through to understand what changed and what that relationship is.

The labels for these questions are pretty clear so I think the actual impact on a user would be relatively low --- most users will understand what happened and not be confused. But this is a best practice we're trying to enforce across VA.gov to ensure a more consistent experience.

Recommended action

I'd recommend moving those revealed fields onto another page following the one thing per page/ask for a single response model. But please reach out in Slack if there are concerns about that solution.

References


Next Steps for the VFS Team

fiorella-io commented 5 months ago

I created the designs which are pending content review #83166 .

steele-lm commented 1 month ago

CAIA has finished there review and the new designs are ready for implementation.