Accessibility Checklists

Accessible Tag Checklist (WCAG)

Every Tag 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 Tag 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 Tag'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 Tag's checklist.

UI rules

RuleLevelRequirementWCAG 2.2Basis
tag/target-sizeMustThe remove button and a link label each take a press over at least 24 × 24px, and at least 44px tall on a touch screen2.5.8 Target Size (Minimum) (AA), 2.5.5 Target Size (Enhanced) (AAA)WCAG 2.5.8 (AA), 2.5.5 (AAA)
tag/contrastMustThe label has at least 4.5:1 against the tag's background, and the focus ring at least 3:1 against what's behind it1.4.3 Contrast (Minimum) (AA), 1.4.11 Non-text Contrast (AA)WCAG 1.4.3, 1.4.11 (AA)
tag/focus-visibleMustThe link and the remove button show an outline at least 2px thick on :focus-visible2.4.7 Focus Visible (AA)WCAG 2.4.7 (AA)
tag/resizableMustThe tag is sized with a min-height in rem, so it grows with its text1.4.4 Resize Text (AA)Open Components, beyond WCAG 1.4.4 (AA)
tag/decorative-iconsMustThe leading icon and the remove button's icon are hidden from assistive technologies1.1.1 Non-text Content (A)WCAG 1.1.1 (A)
tag/link-distinctShouldA link tag looks different from a plain one by more than its colour, like a border1.4.1 Use of Color (A)Open Components, beyond WCAG 1.4.1 (A)

UX rules

RuleLevelRequirementWCAG 2.2Basis
tag/plain-textMustA tag without a link or a remove button has no role and isn't focusableNoneWAI-ARIA
tag/remove-buttonMustRemoval is a native <button type="button">, which Enter and Space press2.1.1 Keyboard (A)HTML, WCAG 2.1.1 (A)
tag/remove-nameMustThe remove button's name includes the tag's text, like "Remove Bug"2.4.6 Headings and Labels (AA), 4.1.2 Name, Role, Value (A)WCAG 2.4.6 (AA), 4.1.2 (A)
tag/disabledMustdisabled drops the remove button, and a link loses its href and takes aria-disabled="true"NoneHTML, WAI-ARIA

AX rules

RuleLevelRequirementWCAG 2.2Basis
tag/role-and-nameMustIt can be found by its parts' roles and names, with getByRole("button", { name: "Remove Bug" }) and, as a link, getByRole("link", { name: "Bug" })4.1.2 Name, Role, Value (A)WCAG 4.1.2 (A)

Sources

Copyright © 2026