Accessibility

4 minutes read

This page lists the WCAG 2.2 success criteria at levels A and AA that the Lateen theme is tested against, and how each is tested. It is written from the gates in this repository and published with each release. It is not an audit by a third party.

What the gates cover

  • axe audits one page for each of the 8 layouts (api, changelog, doc, home, not-found, search-results, tutorial, versions) and each of the 36 components, in light and dark, and fails on any violation.
  • The keyboard gate walks the skip link, the sidebar, search, the mobile drawer, and code tabs, and checks the focused element and a visible focus ring at each step.
  • The contrast gate checks every color pair of the tokens in both modes.
  • The rtl gate checks direction, language, and mirrored icons on right-to-left pages.

Criteria

16 of 21 criteria have an automated check. 5 are checked only by hand: 1.4.4, 1.4.10, 1.4.12, 2.4.11, 3.2.3. Automated tools find only part of the problems for any criterion, so a person still reviews each release.

Criterion Name Level Tested by Notes
1.1.1 Non-text content A axe (tools/axe) axe checks text alternatives; whether an alternative is meaningful is read by a person.
1.3.1 Info and relationships A axe (tools/axe) Landmarks, headings, lists, and table markup.
1.3.2 Meaningful sequence A keyboard gate (tools/keyboard), by hand The keyboard gate follows the reading order; a person checks it with a screen reader.
1.4.1 Use of color A axe (tools/axe) Links in text are underlined or otherwise marked.
1.4.3 Contrast (minimum) AA contrast gate (tools/theme), axe (tools/axe) Every color pair of the tokens is checked at 4.5
(3
for large text), in light and dark.
1.4.4 Resize text AA by hand Sizes are in rem; checked by hand at 200%.
1.4.10 Reflow AA by hand Checked by hand at a 320 px wide window: nothing may scroll sideways.
1.4.11 Non-text contrast AA contrast gate (tools/theme) Focus rings and interface marks are checked at 3
.
1.4.12 Text spacing AA by hand Checked by hand with a text-spacing override.
1.4.13 Content on hover or focus AA keyboard gate (tools/keyboard), by hand Popovers open on focus and close with Escape.
2.1.1 Keyboard A keyboard gate (tools/keyboard) Skip link, sidebar, search, drawer, and code tabs.
2.1.2 No keyboard trap A keyboard gate (tools/keyboard) The drawer and the search dialog trap focus only while open, and return it on close.
2.4.1 Bypass blocks A keyboard gate (tools/keyboard), axe (tools/axe) A skip link is the first stop.
2.4.3 Focus order A keyboard gate (tools/keyboard) The gate checks which element has focus at each step.
2.4.7 Focus visible AA keyboard gate (tools/keyboard) The gate checks that the focus ring is visible at each step.
2.4.11 Focus not obscured (minimum) AA by hand Sticky header and sidebar are checked by hand against a focused link.
2.5.8 Target size (minimum) AA axe (tools/axe) axe's target-size rule.
3.1.1 Language of page A axe (tools/axe), rtl gate (tools/rtl) Every page sets lang and dir; the rtl gate checks Persian pages.
3.1.2 Language of parts AA rtl gate (tools/rtl), by hand Mixed-direction text is isolated; a person checks the wording.
3.2.3 Consistent navigation AA by hand One layout renders the navigation on every page.
4.1.2 Name, role, value A axe (tools/axe), keyboard gate (tools/keyboard) Names and roles of controls.

Report a problem

If something on a Slipway site is hard to use, open an issue in the repository.

View Markdown

Use with an agent
View Markdown

Open in