About a11y examples
What is a11y examples?
a11y examples is a free educational reference for developers learning to build accessible web interfaces. It pairs deliberately inaccessible implementations with improved versions, relevant WCAG guidance, and a browser-based screen reader emulator so readers can compare the experience directly.
The examples are educational demonstrations, not a replacement for testing with disabled users and real assistive technology. The screen reader testing guide explains how to move from the emulator to NVDA, JAWS, VoiceOver, and other production testing tools.
Who maintains this site?
The project was created and is maintained by Martin Kruger. Its source code and revision history are public in the a11y examples GitHub repository . You can also view Martin Kruger’s GitHub profile .
How is the guidance produced?
Each guide aims to show observable behavior: the HTML and ARIA exposed to assistive technology, expected keyboard interaction, and the applicable WCAG success criteria. Pages link to primary sources such as W3C specifications, WCAG Understanding documents, and WAI-ARIA Authoring Practices where relevant.
Accessibility standards and browser behavior change. The visible “last updated” date on each page identifies the latest content revision recorded for that page. If you spot an error or outdated pattern, please use the contact page to report it.
Where should I start?
- Read Getting Started for the learning path.
- Learn How Screen Readers Work.
- Review What’s New in WCAG 2.2.
- Compare Native HTML vs. ARIA.