Starter Template

Definition / explanation of what this component is/how it works.
Impacted Users
Screen reader users need ....
Users with cognitive disabilities need ...
Keyboard users need ... etc.
Designers
Rule that designers must follow.
Rule explanation text here. Rules for designers usually involve annotating the design and conveying accessibility properties to developers to make sure it's coded properly for accessibility.
✅ Do
- Annotate your designs to ....
- Annotate ...
Good Design Example
Screenshot from the figma example.
❌ Don't
- Don't create designs without ...
- Don't design ...
Bad Design Example
Screenshot from the figma example.
Live Figma Example
Link to Figma example
Testing for Accessibility
Design Review
- Look for ... in the design.
- Make sure ... is annotated in the design.
- Make sure ...
- If ... is properly annotated in the design then it passes. ✅
- If ... is not annotated in the design then it fails. ❌
- If ... then it passes. ✅
- If ... then it fails. ❌
Content Designers
Rule text that content designers must follow.
Explanation of rule.
✅ Do
- Write ...
- Markup ...
Good Content Example
See the Pen Heading Structure - Good Example by Paul J. Adam (@pauljadam) on CodePen.
Live Good Content Example
Heading Structure - Good Example❌ Don't
- Don't write ...
- Don't code ...
Bad Content Examples
See the Pen Heading Structure - Bad Example by Paul J. Adam (@pauljadam) on CodePen.
See the Pen Untitled by Paul J. Adam (@pauljadam) on CodePen.
Live Bad Content Examples
Testing for Accessibility
Using Web Inspector
- Right Click > Inspect ... on the page.
- Make sure ...
- Make sure ...
- If ... then it passes. ✅
- If ... then it fails. ❌
Using Screen Reader
- Use the screen reader to navigate to ...
- Make sure ...
- Make sure ...
- If ... then it passes. ✅
- If ... then it fails. ❌
Developers
Rule text developers must follow.
Explanation of rule text.
✅ Do
- Markup ...
- Use ...
- Make sure ...
Good Code Example
See the Pen Heading Levels - Good Example by Paul J. Adam (@pauljadam) on CodePen.
Live Good Code Example
❌ Don't
- Don't use ...
- Don't use ...
- Don't ...
Bad Code Example
See the Pen Heading Levels - Good Example by Paul J. Adam (@pauljadam) on CodePen.
Live Bad Code Example
Testing for Accessibility
Using Web Inspector
- Right Click > Inspect ... on the page.
- Make sure ...
- Make sure ...
- If ... then it passes. ✅
- If ... then it fails. ❌
- If ... then it passes. ✅
- If ... then it fails. ❌
Using Screen Reader
- Use the screen reader to navigate to ...
- Make sure ...
- Make sure ...
- If ... then it passes. ✅
- If ... then it fails. ❌
Disabilities Affected
Assistive Technologies Applicable
Design System Documentation
ARIA Design Patterns
N/A (Don't use ARIA for headings!)
WCAG Success Criteria
Success Techniques for WCAG
- Using h1-h6 to identify headings
- Providing heading elements at the beginning of each section of content
- Providing descriptive headings
- Organizing a page using headings