w3c / html-aria

ARIA in HTML
https://w3c.github.io/html-aria/
Other
181 stars 48 forks source link

Potential for confusion in h1 to h6 implied mapping wording #308

Closed carmacleod closed 3 years ago

carmacleod commented 3 years ago

The Implicit ARIA semantics column for h1 to h6 currently reads:

role=heading, with the aria-level = positive integer.

I have seen this misinterpreted as "role=heading, if the aria-level = positive integer."

I think the following is less ambiguous (delete "with the"):

role=heading, aria-level = positive integer.

If we use some of the words from HTML-AAM, the following may be even clearer?

role=heading, aria-level = the number in the element's tag name.

I'll provide a PR with the 2nd wording, but I'm happy to change it to the shorter wording if that's preferred.