Create more informative conforming/failing examples

scottaohara commented 3 years ago

This was a follow-on work to PR #210. This issue will now track adding multiple new examples. See task list in the following comment.

scottaohara commented 3 years ago

Tasks to complete this issue:

[ ] Create example of a conforming and failing custom element per #210
[x] Create an example regarding the conforming way to 'disable' a link per #186
[ ] Create at example of where authors MAY use an aria-* attribute instead of its HTML equivalent (e.g., button aria-disabled=true).
[x] Create an example of where authors MUST NOT use an aria-* attribute (e.g., aria-checked on a checkbox)
[x] provide any necessary clarity to current examples. e.g., "why" is role=heading not allowed on button, but role=button is allowed on a href

scottaohara commented 1 year ago

incorporating a few of the ideas into PR 441. Merging that will close this, even though not all ideas of what could be added will be added.

w3c / html-aria