GSA / notifications-admin

The UI of Notify.gov
https://notify.gov
Other
11 stars 2 forks source link

Send Message A11Y Audit - Small changes #2133

Open jonathanbobel opened 2 days ago

jonathanbobel commented 2 days ago

Issue: Small Accessibility Improvements

Problem:
There are several small accessibility issues in the Send Message flow that need attention to improve usability and alignment with WCAG standards. These changes will ensure a more inclusive experience for all users, particularly those relying on assistive technologies.


List of Changes:

  1. Replace Acronym Tags (e.g., <acronym>)

    • Problem: Screen readers pronounce acronyms like "CSV" or "TSV" in a halting manner, making it difficult for users to understand.
    • Solution: Replace acronyms with fuller descriptions or provide context with visually hidden text.
      Example:

      <!-- Before -->
      <acronym title="Comma Separated Values">CSV</acronym>
      
      <!-- After -->
      <span aria-label="Comma Separated Values">CSV</span>
  2. Change the breadcrumb to go back to Templates on the Review your Message page

    • Problem: Just having a link that says Templates could be confusing to any user but especially those who use AT
    • Solution: Add a Back to All Templates link to the top of the page
  3. The Templates > Breadcrumb is an H1 and shouldn't be

    • Solution: Make this a
  4. Edit button on Review your message

    • Solution: Change the text of the button to Edit this template to provide more context
  5. Screen reader not picking up Last edited (X) months ago message

    • Problem: VoiceOver just says "Last edited..."
    • Solution: Change the code to make sure the full text is read. It's inside a
  6. Time zone has an underscore

    • Problem: Default selection is America/New_York as the Time Zone - screen readers read the underscore
    • Solution: Make all time zones screen-readable (no underscores).
  7. Image alt for recipient list icon

    • Problem: alt is just "Description Icon"
    • Solution: Just have an empty alt here (alt=""), as it's decorative

Acceptance Criteria:


This issue serves as a general task list for minor accessibility improvements. More items can be added as needed.