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

Accessibility: ARIA role doc-endnote is deprecated. #729

Open
mejiaj opened this issue Sep 22, 2021 · 1 comment
Open

Accessibility: ARIA role doc-endnote is deprecated. #729

mejiaj opened this issue Sep 22, 2021 · 1 comment

Comments

@mejiaj
Copy link

mejiaj commented Sep 22, 2021

doc-backlink, doc-endnote, doc-endnotes, and doc-noteref should be removed and instead rely on native semantic elements like <ol>, <ul>, and <li>.


If you run the ARIA validator extension in Chrome on a page like:
https://designsystem.digital.gov/next/introduction/

You'll get the following:
image

Per DPUB-ARIA 1.0 Recommendation:

23-July-2020: Deprecated the doc-biblioentry and doc-endnote roles due to the inability of them to be recognized as children of list. See issue 15.

You can view the full changelog here: https://w3c.github.io/dpub-aria/#changelog

@BryceStevenWilley
Copy link

doc-backlink, doc-endnote, doc-endnotes, and doc-noteref should be removed and instead rely on native semantic elements like <ol>, <ul>, and <li>.

The dpub ARIA 1.1 working draft that you linked does mention that doc-endnote is deprecated, but it doesn't seem to mention the other roles (doc-backlink, doc-endnotes, and doc-noteref) as being deprecated at all.

The ARIA validator extension hasn't been updated since 2014, and it's code.google.com repo links to a newer chrome extension, which itself is deprecated and links to lighthouse's accessibility audit. Given that dpub-aria was first released in 2016, I don't think the aria validator extension would know about these roles, and would incorrectly mark them as "not existing".

Removing doc-endnote would be simple, but I'm personally not sure how it's currently being used by accessibility technologies, and when it's deprecation would change from being a working draft to a W3C recommendation.

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

2 participants