department-of-veterans-affairs / vets-design-system-documentation

Repository for design.va.gov website
https://design.va.gov
36 stars 55 forks source link

v3 File Input should have a success alert #2947

Open jeana-adhoc opened 2 weeks ago

jeana-adhoc commented 2 weeks ago

Bug Report

What happened

In CAIA Pilot testing for the Form Upload project, we realized a screen reader user has no indication that their file has successfully uploaded.

https://github.com/department-of-veterans-affairs/vets-design-system-documentation/assets/117098918/fe16a44e-f2ab-447b-8dc3-235aa9f20b96

What I expected to happen

After the file upload is complete, a success alert to appear in the file upload box that also receives focus and announces that the file has successfully uploaded.

Reproducing

Steps to reproduce:

  1. Enable a screen reader - I used Mac Voiceover
  2. Navigate to https://staging.va.gov/form-upload/21-0779/upload (you'll have to be logged in)
  3. Upload a file
  4. listen for a notification that your file successfully uploaded
  5. You won't hear a notification.

Urgency

How urgent is this request? Please select the appropriate option below and/or provide details

Details

I don't believe this would be considered launch blocking, and probably an accessibility-defect-2. Mostly annoying/confusing.

humancompanion-usds commented 2 weeks ago

@jeana-adhoc and I talked about this over Slack. We agreed that we should just announce that the file has been added rather than have a success state. We would have found this I suspect in a11y view from @rsmithadhoc but Jeana got there first. So we definitely have a fix to make here but we don't need another visual state.

caw310 commented 2 weeks ago

Hey team! Please add your planning poker estimate with Zenhub @Andrew565 @ataker @harshil1793 @it-harrison @jamigibbs @micahchiang @nickjg231 @powellkerry @rmessina1010 @rsmithadhoc

rsmithadhoc commented 1 week ago

It did announce success in the initial version, but seems to have been lost when we made the visual updates for the multiple file input. So there may be clues in the file history for getting this to work again.

rsmithadhoc commented 6 days ago

I believe it should also alert on Change File or Delete File, so a screen reader user is notified that those operations were successful.