Accordions
A practical Accessibility Field Guide page for checking expandable accordion sections, disclosure buttons, headings, keyboard support, focus, and expanded state.
Common Screen and Workflow Checks
A topic landing page for 9 notes and related guides.
Notes
Notes
Posts, examples, and observations connected to this topic.
Developer Component Checklist
A practical checklist for checking custom buttons, links, names, roles, states, keyboard behavior, focus, and ARIA before component issues become review rework.
ARIA Is Not Duct Tape
Use ARIA to describe real component behavior, not to patch over missing HTML, keyboard support, labels, focus, or state.
Button vs Link
Use buttons for actions and links for navigation so people can predict what will happen before they activate a control.
Name, Role, and Value
Check whether custom controls expose what they are called, what they are, and what state they are in before ARIA becomes guesswork.
Color Contrast
Check whether text, icons, controls, and meaningful visual boundaries are easy to see before contrast becomes a late review finding.
Color-Only Meaning
Do not make color carry the whole message. Pair color with text, shape, labels, icons, or patterns so the meaning is available to everyone.
Alt Text Basics
Write text alternatives that explain the purpose of an image in context, not every pixel in the picture.
Tables and Data Displays
Use tables when relationships matter, keep headers and labels clear, and avoid turning data into a puzzle.
