search

w3c / aria-practices

WAI-ARIA Authoring Practices Guide (APG)
https://www.w3.org/wai/aria/apg/
Other
1.21k stars 345 forks source link

Missing Disclosure HTML element from aria practises docs #1722

Open Felicia5 opened 3 years ago

Felicia5 commented 3 years ago

< dl > < dt > < dd > HTML elements are designed for list of hide/show elements.

https://www.w3.org/TR/wai-aria-practices-1.1/examples/disclosure/disclosure-faq.html or https://www.w3.org/TR/wai-aria-practices-1.2/examples/disclosure/disclosure-faq.html

The above website doesn't mention what MDN does: MDN specify < details > < summary > for single term disclosure widget. https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details

I have tested < details > < summary > on MacBook Pro with VoiceOver on Chrome web browser. It works.

Why is it not included in aria practises documentation?

JAWS-test commented 3 years ago

Most of the examples on this page can also be implemented with HTML and this is always recommended. But here (at APG) it is about showing how it works with ARIA.

Of course, it would make sense to explicitly refer to the HTML alternative for each example. I think there is already a issue for this