Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Request form: .gov domains screen reader output for form validation #2875

Open
4 tasks
Tracked by #3106
AnnaGingle opened this issue Oct 1, 2024 · 0 comments · May be fixed by #3356
Open
4 tasks
Tracked by #3106

Request form: .gov domains screen reader output for form validation #2875

AnnaGingle opened this issue Oct 1, 2024 · 0 comments · May be fixed by #3356
Labels
accessibility pertains to Section 508 compliance or other accessibility needs bundled Parent ticket will be sprinted and this ticket is included in the parent dev issue is for the dev team story User stories

Comments

@AnnaGingle
Copy link

AnnaGingle commented Oct 1, 2024

Story

As a user who relies on screen readers for navigation,
I want to interact with forms that clearly communicate input fields, required information, and error messages,
so that I can complete the form independently and accurately without confusion or frustration.

Screenshot 2024-10-01 at 9 50 30 AM
Screenshot 2024-10-01 at 9 51 37 AM
Screenshot 2024-10-01 at 9 51 57 AM

Acceptance Criteria

For all form fields on the .gov domain page, associate each alert using accessibility best practices:

  • Success state: That domain is available! We’ll try to give you the domain you want, but it's not guaranteed. After you complete this form, we’ll evaluate whether your request meets our requirements.
  • Error state: That domain isn’t available. [Read more about choosing your .gov domain](https://get.gov/domains/choosing).
  • Validation error: Enter the .gov domain you want without any periods.
  • The text inputs are compliant with WCAG 2.1 SC 4.1.2 and Trusted Tester 5.C by properly associating the accessible name, description, and alert messages for each field.

Additional Context

On the .gov domain page each alert isn’t connected to the form field. This fails 5.C programmatic label and WCAG SC 4.1.2

5.C requires that the combination of the accessible name, accessible description, and other programmatic associations (e.g., table column and/or row associations) describes each input field and includes all relevant instructions and cues (textual and graphical).

Issue Links

🔄 Relates to: #2872

Prioritization Comments

WCAG Conformance Level: 2.1 AA
WCAG Standard that applies:
4.1.2 - Name, Role, Value (Critical)
3.3.1 - Error Identification (Critical)
3.3.2 - Labels or Instructions (Critical)
Critical Failure if Not Met?: Yes
Prioritization: Blocker
Reason: Properly associating form field alerts is crucial for screen reader users, as it enables them to accurately understand input requirements, validation errors, and success states. Without this, screen reader users may not perceive critical information about form completion, which severely hinders their ability to submit forms independently and accurately.

@AnnaGingle AnnaGingle added dev issue is for the dev team story User stories accessibility pertains to Section 508 compliance or other accessibility needs labels Oct 1, 2024
@abroddrick abroddrick moved this from 👶 New to 🍦 Backlog in .gov Product Board Oct 7, 2024
@lizpearl lizpearl added the bundled Parent ticket will be sprinted and this ticket is included in the parent label Nov 22, 2024
CocoByte added a commit that referenced this issue Jan 15, 2025
@CocoByte CocoByte linked a pull request Jan 16, 2025 that will close this issue
34 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
accessibility pertains to Section 508 compliance or other accessibility needs bundled Parent ticket will be sprinted and this ticket is included in the parent dev issue is for the dev team story User stories
Projects
Status: 🍦 Backlog
Development

Successfully merging a pull request may close this issue.

2 participants