ENH: Add WAI-ARIA roles to examples/theme/index.html (document, main)

[westurner]

refs #12223

https://en.wikipedia.org/wiki/WAI-ARIA

http://www.w3.org/TR/wai-aria/roles

[cvrebert]

IMHO, the HTML comment seems unnecessary. We don't call out our use of ARIA much elsewhere.

[westurner]

Your call. As a newcomer reading the source (or documentation) it's not immediately clear that while WAI-ARIA markup is extremely helpful, it's not necessary for Bootstrap to function (though it is much easier to understand and build accessibility support in from the start).

Clarification regarding the effect of role='document' / role='application' on keyboard shortcuts may also be helpful, if in scope for this project.

Thanks for your time!

[mdo]

Yeah we don't need the comment. The roles will do just fine though. If you want to call more attention to the ARIA roles, go ahead and submit a PR for the accessibility section of our docs.

[westurner]

Yeah we don't need the comment.

Done.

If you want to call more attention to the ARIA roles, go ahead and submit a PR for the accessibility section of our docs.

http://getbootstrap.com/getting-started/#accessibility

A11Y and MDN Accessibility are both great links.

"site:getbootstrap.com+ARIA" shows markup and a blog post which references #9186

There aren't any direct links to specs. Keyword references to 508 and WCAG may also be helpful.

• https://en.wikipedia.org/wiki/Section_508_Amendment_to_the_Rehabilitation_Act_of_1973
• https://en.wikipedia.org/wiki/Web_Content_Accessibility_Guidelines
• https://en.wikipedia.org/wiki/Web_Accessibility_Initiative
• https://en.wikipedia.org/wiki/Convention_on_the_Rights_of_Persons_with_Disabilities
• https://treaties.un.org/Pages/ViewDetails.aspx?src=TREATY&mtdsg_no=IV-15&chapter=4&lang=en

A Deep link into the MDN ARIA page may be helpful:

• https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA
  • "Accessible JS Widget Library Demos"

[westurner]

Clarification regarding the effect of role='document' / role='application' on keyboard shortcuts may also be helpful, if in scope for this project.

http://a11yproject.com/posts/how-to-use-application-role/

[cvrebert]

Merged as a73dacf.