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

Baseline box: <h2> in <summary> might be a problem #8849

Open
3 tasks done
simevidas opened this issue May 12, 2023 · 2 comments
Open
3 tasks done

Baseline box: <h2> in <summary> might be a problem #8849

simevidas opened this issue May 12, 2023 · 2 comments
Labels
♿ a11y An MDN Web Docs accessible by everyone 🐛 bug Something isn't working, or isn't working as expected effort: small This task is a small effort. idle p2 We want to address this but may have other higher priority items. plus:baseline

Comments

@simevidas
Copy link

Summary

The new Baseline <details> element has a heading in its summary.

<summary>
    <!-- other content -->
    <h2>
        Baseline: <span>Widely supported</span>
    </h2>
    <!-- other content -->
</summary>

This heading is ignored by screen readers because the entire <summary> content is read out as a single text summary. See the Warning box on this page:

https://developer.mozilla.org/docs/Web/HTML/Element/summary#summaries_as_headings

Should the heading be there? What purpose does it have? Does this cause problems for users? Should the heading be replaced by a <span>?

URL

https://developer.mozilla.org/docs/Web/CSS/@layer

Reproduction steps

  1. Open the linked page and inspect the Baseline box in devtools DOM inspector

Expected behavior

Maybe there shouldn’t be a heading in summary.

Actual behavior

There is a heading in summary.

Device

Desktop

Browser

Safari

Browser version

Stable

Operating system

Mac OS

Screenshot

Screenshot 2023-05-12 at 14 00 23

Anything else?

No response

Validations

@github-actions github-actions bot added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label May 12, 2023
@simevidas
Copy link
Author

Relevant standards discussion: whatwg/html#2272

@caugner caugner added 🐛 bug Something isn't working, or isn't working as expected p2 We want to address this but may have other higher priority items. ♿ a11y An MDN Web Docs accessible by everyone and removed needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. labels Sep 28, 2023
@caugner
Copy link
Contributor

caugner commented Sep 28, 2023

@simevidas Thank you for raising this issue. 👍

I skimmed through the linked standards discussion and agree that we should avoid the heading in the summary element.

@caugner caugner changed the title <h2> in <summary> might be a problem Baseline box: <h2> in <summary> might be a problem Oct 6, 2023
@github-actions github-actions bot added the idle label Jan 24, 2024
@caugner caugner added the effort: small This task is a small effort. label Jun 24, 2024
@github-actions github-actions bot removed the idle label Jun 24, 2024
@github-actions github-actions bot added the idle label Jul 25, 2024
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 🐛 bug Something isn't working, or isn't working as expected effort: small This task is a small effort. idle p2 We want to address this but may have other higher priority items. plus:baseline
Projects
None yet
Development

No branches or pull requests

2 participants