Accessibility Checker

[Karellen]

Hi @kovidgoyal

Thanks for the latest update.

I noticed the new Accessibility Checker and wanted to give it a try.

The image shows a <h4> heading. This skips a level as there is no <h3> heading above it, only a <h2>.

It shows an epub:type with no matching Aria role.

The checker didn't pick up on either of these. Something I am misunderstanding?

[kovidgoyal]

The heading level checker had a bug, it didnt catch the first heading in a new html file, now fixed.

epub:type without an ARIA role: correct behaviour. epub:type="chapter" matches the role doc-chapter, but ARIA doesn't allow that role on headings, only on things like <section>. Adding it would make the markup invalid, so the checker rightly doesn't suggest it. The real problem is that chapter doesn't belong on an <h4>; it should be on the surrounding <section> or <body>.

[Karellen]

Originally Posted by kovidgoyal

The heading level checker had a bug, it didnt catch the first heading in a new html file, now fixed.

Great. Thank you.

Originally Posted by kovidgoyal

but ARIA doesn't allow that role on headings, only on things like <section>.

Ok, thanks. I added that epub:type as a test, but also I wasn't aware of that requirement.

I've checked using a <section> tag as suggested, and it captured the missing aria role.

Is it expected that it does not work in reverse - have the aria role, but the epub:type is missing?

[kovidgoyal]

yes, it is, accessibility relies on aria roles not epub:type, so the checker does not care too much about epub:type

[Karellen]

Great. Thanks!!