-
Notifications
You must be signed in to change notification settings - Fork 56
Docs accessibility issues
Gaël Poupard edited this page Jan 7, 2021
·
16 revisions
On v5-dev
, pa11y-ci is configured to ignore a few things.
Here's a comprehensive list of ignored rules and elements, to discuss:
-
Upstream: The
heading-order
rule is ignored, since Bootstrap doesn't want to improve their heading hierarchy (and this is probably not a big deal—see "When do headings fail WCAG?" on The Paciello Group's blog). -
3rd party:
.bd-search
is ignored, it comes from Algolia. -
3rd party:
[id*='tarteaucitron']
for, well, Tarteaucitron, which is a nightmare to fix at some point. -
3rd party:
#TableOfContents
is flagged as redundantnav
landmark, which is generated by Hugo (so we can't change it) and moreover is not an issue at all. -
Orange brand:
.text-primary
,.navbar-light .navbar-brand
,.active
,[aria-current]
,.accordion-button:not(.collapsed)
are ignored since their contrasts aren't sufficient (#f16e00
on#fff
, brand side). -
Orange brand:
select:disabled
,[disabled] label
and[disable + label]
for contrast issues (brand side), however WCAG 2.1 does not require sufficient contrast for inactive elements. -
.modal
since it's flagged asaria-hidden
containing interactive content: this is how the modal works… -
.bd-example nav
is flagged too for the same reason, but it's meant to documentnav
usage, so…
To maybe fine-tune our criterias, pa11y's wiki has a comprehensive list of ignorable rules.