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.