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

overlay notebook semantics onto the screen reader with aria-roledescription #28

Open
tonyfast opened this issue Dec 31, 2023 · 1 comment

Comments

@tonyfast
Copy link
Member

we use the following generic aria roles region and group to describe cells, inputs and outputs. we actually overlay notebook semantics onto the screen reader with aria-roledescription. when this feature is added, it should be easy to toggle on/off. screen reader power users might prefer familiar screen reader cues while renamed descriptions are more conversational.

@tonyfast
Copy link
Member Author

marking up notebooks semantic might be a plausible uses case:

If you have a very specific audience, that is homogeneous in language, in skill, in experience, and in technology, and that audience has struggled with a specific concept or control, then sure, maybe experiment.

There is some guidance: no blank values, only use it on things that already have implicit or explicit roles, and use it only to clarify a thing.

https://adrianroselli.com/2020/04/avoid-aria-roledescription.html

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

No branches or pull requests

1 participant