ARIA Is Not Duct Tape
Use ARIA to describe real component behavior, not to patch over missing HTML, keyboard support, labels, focus, or state.
Tommy Truong
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.
Status Messages and Alerts
A practical Field Guide page about making save messages, alerts, loading updates, and other screen changes understandable without forcing users to hunt for them.
Modals and Dialogs
A practical Field Guide page about making modals and dialogs understandable, keyboard-accessible, and easy to escape.
Headings and Page Structure
A practical Field Guide page about using headings to make screens easier to scan, navigate, and review.
