Accessibility Checklists
Accessible Card Checklist (WCAG)
Every Card rule that WCAG 2.2, WAI-ARIA or the APG backs, in one checklist, with the success criteria behind each rule and their level.
Here's every rule for the Card that WCAG 2.2, WAI-ARIA or the APG backs, in one list you can work through when you build or review one. Each row names the WCAG 2.2 success criteria behind its rule, with their level, and links to the rule's table on its layer's page, where we explain why it's there. A rule that rests on WAI-ARIA or the APG alone says "None".
We build this list from the Card's checklists, so it always matches them. It leaves out the rules that rest only on HTML and the ones that are our own, so you'll find every rule in the Card's checklist.
UI rules
| Rule | Level | Requirement | WCAG 2.2 | Basis |
|---|---|---|---|---|
card/contrast | Must | The text, the eyebrow and the footer included, has a contrast of 4.5:1 against the card, and the focus ring has 3:1 against the page | 1.4.3 Contrast (Minimum) (AA), 1.4.11 Non-text Contrast (AA) | WCAG 1.4.3, 1.4.11 (AA) |
card/focus-visible | Must | When its link has keyboard focus, an outline at least 2px thick shows around the whole card, outside its border | 2.4.7 Focus Visible (AA), 2.4.13 Focus Appearance (AAA) | WCAG 2.4.7 (AA), 2.4.13 (AAA) |
card/resizable | Must | Nothing in the card has a fixed height, so it grows with its text, and long words wrap instead of overflowing it | 1.4.4 Resize Text (AA), 1.4.12 Text Spacing (AA) | Open Components, beyond WCAG 1.4.4, 1.4.12 (AA) |
card/reduced-motion | Must | Nothing moves on hover or focus when prefers-reduced-motion: reduce is set | 2.3.3 Animation from Interactions (AAA) | WCAG 2.3.3 (AAA) |
card/reflow | Must | Cards in a grid get narrower rather than overflow, so the page never scrolls sideways at 320px wide | 1.4.10 Reflow (AA) | WCAG 1.4.10 (AA) |
UX rules
| Rule | Level | Requirement | WCAG 2.2 | Basis |
|---|---|---|---|---|
card/semantic-element | Must | It's an <article> by default, or a <section>, <div> or <li> with as, and never a link or a button | 1.3.1 Info and Relationships (A) | Open Components, beyond WCAG 1.3.1 (A) |
card/list-of-cards | Should | A set of cards is a list, with each card an <li> | 1.3.1 Info and Relationships (A) | WCAG 1.3.1 (A) |
card/heading | Must | Every card has a heading that says what it's about, at the level that fits the page's outline | 1.3.1 Info and Relationships (A), 2.4.6 Headings and Labels (AA) | WCAG 1.3.1 (A), 2.4.6 (AA) |
card/stretched-link | Must | A card that's a link has one link, in its heading, stretched over the card with a pseudo-element, and never a wrapping <a>, role="link" or a click handler on the card | 2.1.1 Keyboard (A), 4.1.2 Name, Role, Value (A) | Open Components, beyond WCAG 2.1.1, 4.1.2 (A) |
card/link-name | Must | The link is named by the heading alone | 2.4.4 Link Purpose (In Context) (A) | WCAG 2.4.4 (A) |
card/link-purpose | Should | Headings say where the link goes, differ from card to card, and there's no separate "Read more" link | 2.4.4 Link Purpose (In Context) (A), 2.4.9 Link Purpose (Link Only) (AAA) | WCAG 2.4.4 (A), 2.4.9 (AAA) |
card/keyboard | Must | Tab reaches the card's link once and then its actions, and Enter follows the link | 2.1.1 Keyboard (A), 2.4.3 Focus Order (A) | WCAG 2.1.1, 2.4.3 (A) |
card/media-alt | Must | An image that only illustrates the heading has alt="", and one that shows more has alt text that says what | 1.1.1 Non-text Content (A) | WCAG 1.1.1 (A) |
card/static-media | Must | The media holds nothing people can focus, since it's shown above the heading but comes after it in the DOM | 1.3.2 Meaningful Sequence (A), 2.4.3 Focus Order (A) | WCAG 1.3.2, 2.4.3 (A) |
card/dom-order | Must | Cards come in the same order in the DOM as on screen, without order, row-reverse or a dense grid | 1.3.2 Meaningful Sequence (A), 2.4.3 Focus Order (A) | Open Components, beyond WCAG 1.3.2, 2.4.3 (A) |
card/focus-not-obscured | Must | Sticky headers and footers never cover a focused card, for example thanks to scroll-padding | 2.4.11 Focus Not Obscured (Minimum) (AA), 2.4.12 Focus Not Obscured (Enhanced) (AAA) | WCAG 2.4.11 (AA), 2.4.12 (AAA) |
card/announce-results | Should | Cards that load after something people did, like a search, are announced with a status message | 4.1.3 Status Messages (AA) | WCAG 4.1.3 (AA) |
AX rules
| Rule | Level | Requirement | WCAG 2.2 | Basis |
|---|---|---|---|---|
card/role-and-name | Must | It can be found by its heading, with getByRole("heading", { name }), and a card that's a link by getByRole("link", { name }) | 4.1.2 Name, Role, Value (A) | WCAG 4.1.2 (A) |
Sources
- Web Content Accessibility Guidelines (WCAG) 2.2, for each success criterion's number, short name and level
- Understanding WCAG 2.2, which each criterion links to
- Card, where each rule is explained, with the sources it draws on