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

Should the ARIA spec suggest setting a description on dialogs? #1739

Open
joanmarie opened this issue May 11, 2022 · 5 comments · May be fixed by #2054
Open

Should the ARIA spec suggest setting a description on dialogs? #1739

joanmarie opened this issue May 11, 2022 · 5 comments · May be fixed by #2054
Assignees
Labels
Projects
Milestone

Comments

@joanmarie
Copy link
Contributor

joanmarie commented May 11, 2022

It would be nice to have a more consistent, interoperable presentation of dialogs and alertdialogs (both native and ARIA). One possibility would be to encourage authors to put the contents to be presented in a description via aria-description or aria-describedby, and then encourage ATs to prefer that content over whatever they currently do when presenting a newly opened dialog/alertdialog.

There is already some precedent in using this technique:

  • Firefox exposes JavaScript alert contents via the accessible description.
  • NVDA and Orca present the accessible description, when present, of dialogs as the message content

Also Chromium may start doing something similar (we're discussing it). If it does, and WebKit also does it, then we just need buy-in from the other screen readers.

@joanmarie
Copy link
Contributor Author

@cookiecrook: Any thoughts on this, both in terms of WebKit and in terms of VoiceOver? Thanks!

@scottaohara
Copy link
Member

related: #1195

@aleventhal
Copy link
Contributor

@joanmarie for alert, do you mean alertdialog?
Because I think it's easy to determine what to announce for a basic alert -- just the inner text as if from a name from contents computation.

@joanmarie
Copy link
Contributor Author

@joanmarie for alert, do you mean alertdialog? Because I think it's easy to determine what to announce for a basic alert -- just the inner text as if from a name from contents computation.

Yeah. I have JavaScript alert on my mind at the moment and wasn't thinking in terms of ARIA roles. I've edited the opening comment. Sorry for any confusion!

@jnurthen
Copy link
Member

@pkra pkra added this to Scott O'Hara in ARIA 1.3 Sep 7, 2022
scottaohara added a commit that referenced this issue Oct 2, 2023
Closes: #1195 adds content pertaining to aria-describedby/description and aria-modal (with linking to APG).

Closes: #1739 adds AT SHOULD to address the treatment of dialog descriptions. This could probably be worded better.  Suggestions welcome.
@scottaohara scottaohara linked a pull request Oct 2, 2023 that will close this issue
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
ARIA 1.3
Scott O'Hara
Development

Successfully merging a pull request may close this issue.

5 participants