Skip to content

Add a11y guidance for user agents #238

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

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

MasterKale
Copy link

@MasterKale MasterKale commented May 13, 2025

This PR adds informative guidance to user agents encouraging them to mediate presentation and issuance requests in a way that supports a wide range of accessible inputs and outputs.

The intent is to submit this content in the horizontal review request to the a11y-request repo.

Partially closes #229

The following tasks have been completed:

  • Modified Web platform tests (link)

Implementation commitment:

  • WebKit (link to issue)
  • Chromium (link to issue)
  • Gecko (link to issue)

Documentation and checks

  • Affects privacy
  • Affects security
  • Pinged MDN
  • Updated Explainer
  • Updated digitalcredentials.dev

Preview | Diff

@MasterKale MasterKale requested a review from a team as a code owner May 13, 2025 21:13
index.html Outdated
input hardware like keyboards, pointing devices, touch screens, voice
recognition, etc. Additionally, user agents SHOULD support accessible
output methods during these requests to ensure that prompts for
[=user consent=] during such requests can be meaningfully communicated to
Copy link
Collaborator

@timcappalli timcappalli May 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We've traditionally said that the browser only handles permission, not consent.

It seems we have a mismatch on the term definition / section title and meaning. Opened an issue here: #239

@MasterKale MasterKale added the agenda+ Add to the weekly agenda label May 28, 2025
@marcoscaceres
Copy link
Collaborator

This is good, though quite broad and generally applicable to any UI. As we depend on the Credential Management API for credential selection, we need to push this down to the CM API level instead (if not already covered):
https://w3c.github.io/webappsec-credential-management/#user-mediated-selection

Then in our spec we would just say, "See the Credential Management API for the Accessibility Considerations when selecting a credential."

@wseltzer
Copy link
Contributor

Discussed 11 June minutes

@wseltzer wseltzer removed the agenda+ Add to the weekly agenda label Jun 12, 2025
@marcoscaceres
Copy link
Collaborator

The the holder serves as a "credential chooser", which needs to:

  • be keyboard accessible particularly allowing the user to abort an request or issuance operation (e.g., you should be able to hit "esc" to abort the operation)
  • present what is being requested should accessible to screen readers.
  • Make sure the QR code is labelled

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

Successfully merging this pull request may close these issues.

Horizontal Review - Accessibility
4 participants