Skip to content

Conversation

jnurthen
Copy link
Member

@jnurthen jnurthen commented Aug 12, 2025

This is still very draft and prototype only.

  • Add CSS styling for .at-guidance sections with visual distinction
  • Implement comprehensive AT guidance for suggestion role with screen reader recommendations
  • Add AT guidance for slider role covering screen readers, voice control, and switch navigation
  • Add AT guidance for aria-expanded state with platform-specific implementation details
  • Add editorial documentation to README.md explaining when and how to add AT guidance
  • Use proper h5/h6 heading hierarchy for AT guidance sections
  • Include RFC 2119 compliant language (MUST, SHOULD, MAY) for normative guidance
  • Provide concrete examples and focus on user benefits for each AT guidance section

Closes #????

Describe Change Here!

And a few other todo items (delete this section after performing them):

  • For every spec that this PR edits, please add the appropriate spec:<spec_name> label. If you don't have privileges to do this, editors will do it for you.
  • If the change is editorial, please add "Editorial:" at the start of your PR name, and delete the "Test, Documentation and Implementation tracking" section below.

Test, Documentation and Implementation tracking

Once this PR has been reviewed and has consensus from the working group, tests should be written and issues should be opened on browsers. Add N/A and check when not applicable.

  • "author MUST" tests:
  • "user agent MUST" tests:
  • Browser implementations (link to issue or commit):
    • WebKit:
    • Gecko:
    • Blink:
  • ACT review?
  • Does this need AT implementations?
  • Related APG Issue/PR:
  • MDN Issue/PR:

Preview | Diff

- Add CSS styling for .at-guidance sections with visual distinction
- Implement comprehensive AT guidance for suggestion role with screen reader recommendations
- Add AT guidance for slider role covering screen readers, voice control, and switch navigation
- Add AT guidance for aria-expanded state with platform-specific implementation details
- Add editorial documentation to README.md explaining when and how to add AT guidance
- Use proper h5/h6 heading hierarchy for AT guidance sections
- Include RFC 2119 compliant language (MUST, SHOULD, MAY) for normative guidance
- Provide concrete examples and focus on user benefits for each AT guidance section
Copy link

netlify bot commented Aug 12, 2025

Deploy Preview for wai-aria ready!

Name Link
🔨 Latest commit 9e2cebb
🔍 Latest deploy log https://app.netlify.com/projects/wai-aria/deploys/689babd67cebf30008dde618
😎 Deploy Preview https://deploy-preview-2597--wai-aria.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant