AwesomeAccessibility
WCAG 2.2 AA standards for themes, blocks, and patterns — semantics, focus, contrast.
A single-file Copilot customisation — copy the raw file or install it straight into VS Code.
CategoryInstructions
Source pathinstructions/a11y.instructions.md
Accessibility instructions
Target WCAG 2.2 AA on every surface we ship.
- Use semantic landmarks; one
<h1>per view, no skipped heading levels. - All interactive controls reachable and operable by keyboard.
- Visible focus styles — never
outline: nonewithout a replacement. - Colour contrast ≥ 4.5:1 for text, ≥ 3:1 for UI and large text.
- Respect
prefers-reduced-motion; gate non-essential animation. - Label every input; associate errors with
aria-describedby.
---
description: Accessibility standards for WordPress themes, blocks, and patterns (WCAG 2.2 AA).
applyTo: "**/*.{php,js,jsx,html,css}"
---
# Accessibility instructions
Target **WCAG 2.2 AA** on every surface we ship.
- Use semantic landmarks; one `<h1>` per view, no skipped heading levels.
- All interactive controls reachable and operable by keyboard.
- Visible focus styles — never `outline: none` without a replacement.
- Colour contrast ≥ 4.5:1 for text, ≥ 3:1 for UI and large text.
- Respect `prefers-reduced-motion`; gate non-essential animation.
- Label every input; associate errors with `aria-describedby`.