From 600cfda900eba9e3bc370c5e7fcd1b6568619a5d Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Wed, 15 Apr 2026 19:24:55 -0400 Subject: [PATCH] Clarify accessibility criteria descriptions (#1405) * Clarify accessibility criteria descriptions I have not been able to look through everything in the accessibility instruction file. But the changes I'm submitting attempt to clarify / correct content that needed it. * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Apply suggestion from @scottaohara * Apply suggestion from @scottaohara --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- instructions/a11y.instructions.md | 44 ++++++++++++++++--------------- 1 file changed, 23 insertions(+), 21 deletions(-) diff --git a/instructions/a11y.instructions.md b/instructions/a11y.instructions.md index 1c1965a0..950630f6 100644 --- a/instructions/a11y.instructions.md +++ b/instructions/a11y.instructions.md @@ -25,17 +25,17 @@ Comprehensive accessibility rules for web application development. Every anti-pa | 1.2.1 Audio/Video-only | A | Provide transcript (audio) or text alternative (video). | | 1.2.2 Captions (Prerecorded) | A | All prerecorded video has synchronized captions. | | 1.3.1 Info and Relationships | A | Structure (headings, lists, tables, labels, landmarks) programmatically conveyed. | -| 1.3.2 Meaningful Sequence | A | DOM reading order matches visual order. | +| 1.3.2 Meaningful Sequence | A | When the sequence that content is presented affects its meaning, the visual and programmatic ordering of content should align. | | 1.3.3 Sensory Characteristics | A | Instructions don't rely solely on shape, size, position, or sound. | -| 1.3.4 Orientation | AA | Content not restricted to single orientation unless essential. | -| 1.3.5 Identify Input Purpose | AA | Input fields have `autocomplete` attributes for user data (name, email, tel). | +| 1.3.4 Orientation | AA | Content is not restricted to single orientation unless essential. | +| 1.3.5 Identify Input Purpose | AA | Input fields have `autocomplete` attributes when collecting information about the user. | | 1.4.1 Use of Color | A | Color is not the only means of conveying info. | | 1.4.3 Contrast (Minimum) | AA | Text: 4.5:1 normal, 3:1 large (18pt / 14pt bold). | -| 1.4.4 Resize Text | AA | Text resizable to 200% without loss of content. | -| 1.4.10 Reflow | AA | Content reflows at 320px CSS width (no horizontal scroll). | +| 1.4.4 Resize Text | AA | Text resizable to 200% without loss of content or functionality. | +| 1.4.10 Reflow | AA | Sections of content can fit within 320px CSS width viewports without needing to scroll in two dimensions to read. | | 1.4.11 Non-text Contrast | AA | UI components and graphics: 3:1 against adjacent colors. | -| 1.4.12 Text Spacing | AA | No loss of content with overridden line-height (1.5x), spacing. | -| 1.4.13 Content on Hover/Focus | AA | Tooltips: dismissible, hoverable, persistent. | +| 1.4.12 Text Spacing | AA | No loss of content or functionality with user-overridden line-height (1.5x), or specified paragraph spacing, letter spacing, and word spacing adjustments. | +| 1.4.13 Content on Hover/Focus | AA | Popup content that appears on hover or focus is: dismissible, hoverable, persistent. | ### Operable @@ -52,13 +52,13 @@ Comprehensive accessibility rules for web application development. Every anti-pa | 2.4.4 Link Purpose | A | Link purpose determinable from text or context. | | 2.4.6 Headings and Labels | AA | Headings and labels describe topic or purpose. | | 2.4.7 Focus Visible | AA | Keyboard focus indicator is visible. | -| 2.4.11 Focus Not Obscured | AA | Focused element not entirely hidden by sticky headers/footers. *(New in 2.2)* | +| 2.4.11 Focus Not Obscured | AA | Focused element not entirely hidden by other overlaying elements (such as sticky headers or footers). *(New in 2.2)* | | 2.5.1 Pointer Gestures | A | Multi-point gestures have single-pointer alternative. | -| 2.5.2 Pointer Cancellation | A | Activation on up-event, not down-event. | -| 2.5.3 Label in Name | A | Accessible name contains the visible label text. | +| 2.5.2 Pointer Cancellation | A | Activation on up-event, unless activation can be aborted, reversed, or down-event activation is essential. | +| 2.5.3 Label in Name | A | Accessible name contains the label text as it is visually presented. | | 2.5.4 Motion Actuation | A | Device motion has UI alternative and can be disabled. | | 2.5.7 Dragging Movements | AA | Drag-and-drop has click/tap alternative. *(New in 2.2)* | -| 2.5.8 Target Size (Minimum) | AA | Touch targets at least 24x24 CSS px. *(New in 2.2)* | +| 2.5.8 Target Size (Minimum) | AA | Interactive controls have a target size, or spacing of at least 24x24 CSS px. *(New in 2.2)* | ### Understandable @@ -102,7 +102,7 @@ Comprehensive accessibility rules for web application development. Every anti-pa ## Five Rules of ARIA 1. **Prefer native HTML** — Use `