Update examples based on expert feedback
jgarber623 opened this issue · 0 comments
jgarber623 commented
See the conversation here with feedback from Adrian Roselli. Their article on disclosure widgets recommends:
Ensure the disclosed content immediately follows the control in the DOM. For screen reader users this allows them to continue reading without the need to hunt for the content. If the disclosed content includes interactive controls (tab stops), this allows keyboard users to quickly move to those controls.
As linked from the article, the WAI-ARIA Authoring Practices 1.1 site has some examples here: disclosure patterns
So, probably best to remove the "Toggle Notes" example as it doesn't conform well to user expectations or AT capabilities without more work.