Visitar URL original
USWDS - Feature: Remove added aria instructions to make screen reader callouts less verbose · Issue #5955 · uswds/uswds · GitHub
Skip to content

USWDS - Feature: Remove added aria instructions to make screen reader callouts less verbose #5955

Closed

Description

@amycole501

Is your feature request related to a problem? Please describe.

When auditing the combo box component and checking against WCAG 3.3.2, I noticed the ARIA instructions were verbose. Given that they are very specific instructions, in order to pass that Success Criteria, should we also reflect those instructions visibly on the page?

Here's what it says:
When autocomplete results are available use up and down arrows to review and enter to select.
Touch device users, explore by touch or with swipe gestures.

Based on feedback from AT users during our Buffalo batch of usability research testing, most screen reader users were familiar with how to navigate a combo box with a keyboard. Issues found during testing didn't reveal those instructions were necessary.

If we were to leave the instructions as-is we'd want to add recommendations visibly on the page that reflect the keyboard usability. We feel the majority of users know how to interact with a combo box and the instructions are an unnecessary addition that would make the user experience more cumbersome visibly and potentially, audibly.

Describe the solution you'd like

Remove lines L264-267. Instructions are too general to be helpful.

<span id="${assistiveHintID}" class="usa-sr-only">
When autocomplete results are available use up and down arrows to review and enter to select.
Touch device users, explore by touch or with swipe gestures.
</span>`,

Describe alternatives you've considered

We considered adding instructions visible on the page that reflect the audible ARIA instructions. However, that would lengthen the page unnecessarily. We'd follow this guidance https://www.w3.org/WAI/WCAG21/Understanding/labels-or-instructions that suggests instructions be equally visible and audible (ie accessible to all users). In order to pass this SC, we recommend removing those additional keyboard instructions so the visible and audible instructions are more analagous.

Additional context

No response

Code of Conduct

Activity

  1. added
    Type: Feature RequestCompatibility label; native Enhancement type is authoritative. Retained for templates/search links.
    Package: Combo BoxWork affecting Combo Box. Apply only when this area helps route or find the issue.
    A11y AuditAccessibility audit work or its findings. Preserve the test scope and evidence in the issue.
    on Jun 14, 2024
  2. moved this to Ready to Schedule in USWDS Core Project Dataon Jul 11, 2024
  3. added this to the uswds 3.9.0 milestone on Jul 11, 2024
  4. moved this from Ready to Schedule to Scheduled in USWDS Core Project Dataon Jul 11, 2024
  5. added
    Role: DevDev expertise is relevant. Project Active Role tracks ownership; this label is not an assignment.
    and removed
    Type: Feature RequestCompatibility label; native Enhancement type is authoritative. Retained for templates/search links.
    on Jul 11, 2024
  6. moved this from Scheduled to Ready to Schedule in USWDS Core Project Dataon Jul 22, 2024
  7. added
    Added during SprintHistorical record of work added during a sprint. Not required for current triage.
    on Jul 30, 2024
  8. moved this from Ready to Schedule to Scheduled in USWDS Core Project Dataon Aug 12, 2024
  9. moved this from Scheduled to In progress in USWDS Core Project Dataon Aug 12, 2024
  10. moved this from In progress to Review in USWDS Core Project Dataon Aug 14, 2024
  11. moved this from Review to Fed Final Review in USWDS Core Project Dataon Aug 19, 2024
  12. moved this from Fed Final Review to Done in USWDS Core Project Dataon Oct 4, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

A11y AuditAccessibility audit work or its findings. Preserve the test scope and evidence in the issue.Added during SprintHistorical record of work added during a sprint. Not required for current triage.Context: JavaScriptIssue is in JavaScriptPackage: Combo BoxWork affecting Combo Box. Apply only when this area helps route or find the issue.Role: DevDev expertise is relevant. Project Active Role tracks ownership; this label is not an assignment.

Type

No type

Projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions