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

Deprecated/Experimental/Non-standard badges are not accessible #5905

Open
anna-yeddi opened this issue Apr 4, 2022 · 4 comments
Open

Deprecated/Experimental/Non-standard badges are not accessible #5905

anna-yeddi opened this issue Apr 4, 2022 · 4 comments
Labels
♿ a11y An MDN Web Docs accessible by everyone idle p2 We want to address this but may have other higher priority items.

Comments

@anna-yeddi
Copy link

MDN URLs:

What information was incorrect, unhelpful, or incomplete?

The icons used to communicate status of properties and attributes, i.e. "deprecated", "non-standard", "experimental", lack accessible names and on-screen tooltips to provide users with their purpose. This affects users of assistive technologies (especially those who cannot see the screen/image), users with cognitive difficulties, as well as newer users of MDN.

Specific section or headline?

  • Related Topics (sidebar)
  • List of Global Attributes
  • Properties, etc.

What did you expect to see?

Non-standard:
<symbol id="icon-nonstandard" viewBox="0 0 16 13.6" role="img" aria-label="Non-standard" title="Non-standard. Check cross-browser support before using.">...</symbol>
Deprecated:
<symbol id="icon-deprecated" viewBox="0 0 100 100" role="img" aria-label="Deprecated" title="Deprecated. Not for use in new websites.">...</symbol>

Did you test this? If so, how?

  • Review of DOM
  • Accessibility inspector on Firefox
  • Screen reader (VoiceOver on macOS)
MDN Content page report details
@github-actions github-actions bot added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Apr 4, 2022
@sideshowbarker sideshowbarker added Content:HTML and removed needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. labels Apr 4, 2022
@wbamberg wbamberg transferred this issue from mdn/content Apr 5, 2022
@github-actions github-actions bot added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Apr 5, 2022
@wbamberg
Copy link
Collaborator

wbamberg commented Apr 5, 2022

Thanks for filing! I'm transferring this, because it looks like a platform issue.

@danielhjacobs
Copy link
Contributor

There's an open PR to replace these with something else: #5644

I'm not familiar with screen readers, so I don't know if that will work exactly right. The new format for these icons will be:

<abbr class="icon icon-deprecated" title="Deprecated. Not for use in new websites.">
    <span class="visually-hidden">Deprecated</span>
</abbr>

<abbr class="icon icon-experimental" title="Experimental. Expect behavior to change in the future.">
    <span class="visually-hidden">Experimental</span>
</abbr>

<abbr class="icon icon-nonstandard" title="Non-standard. Check cross-browser support before using.">
    <span class="visually-hidden">Non-Standard</span>
</abbr>

Hopefully that hidden span will work equally as well as an aria-label.

@schalkneethling
Copy link

@danielhjacobs Indeed but, it will not solve the accessibility problem. We are having a larger discussion about this and will soon open a discussion here on the Yari repo to get community input.

@schalkneethling schalkneethling added ♿ a11y An MDN Web Docs accessible by everyone p1 We will address this soon and will provide capacity from our team for it in the next few releases. and removed needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. Content:HTML labels Apr 16, 2022
@github-actions github-actions bot added the 🐌 idle Issues and PRs without recent activity. Flagged for maintainer follow-up. label May 28, 2022
@caugner
Copy link
Contributor

caugner commented Oct 19, 2022

In the mean-time, the icons do have accessible names:
image

However:

  1. They are not focusable, so they won't be read by screen-reader (tested with VoiceOver).
  2. The title is probably too verbose for screen-readers, so we might want to add aria-labels with just "Deprecated [feature]" and "Non-standard [feature]".
  3. It might make more sense to have the feature state icons after the feature name.

@caugner caugner changed the title Issue with Icon Badges: SVG images lack accessible name and on-screen titles Deprecated/Experimental/Non-standard badges in sidebar are not accessible Oct 19, 2022
@caugner caugner changed the title Deprecated/Experimental/Non-standard badges in sidebar are not accessible Deprecated/Experimental/Non-standard badges are not accessible Oct 19, 2022
@github-actions github-actions bot removed the 🐌 idle Issues and PRs without recent activity. Flagged for maintainer follow-up. label Nov 15, 2022
@caugner caugner added p2 We want to address this but may have other higher priority items. and removed p1 We will address this soon and will provide capacity from our team for it in the next few releases. labels Dec 1, 2022
@github-actions github-actions bot added the idle label Dec 31, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
♿ a11y An MDN Web Docs accessible by everyone idle p2 We want to address this but may have other higher priority items.
Projects
Development

No branches or pull requests

6 participants