Skip to main content

Accessibility

Floors the system must hold.

size.control.default size.control.compact size.control.large opacity.disabled color.border.focus

The five answers​

QuestionAnswerWhy
Which states get their own visible value?All, including loadingEvery state, including loading, gets its own value.
How many signals carry each meaning?Three: color, icon and wordNever color alone.
What contrast floor do we hold?AAA for textAAA contrast for text.
What is the smallest target?LargeLarge targets for tremor and touch.
Where are the floors hardest to hold?FormsForms are where people are blocked.

Tokens​

Each token points to another token. Values live only on primitives, below.

TokenPoints to, lightPoints to, dark
size.control.defaultsize.52size.52
size.control.compactsize.48size.48
size.control.largesize.52size.52
opacity.disabledopacity.50opacity.50
color.border.focusaccessible-first.theme.light.color.border.focus → color.blue.light.600accessible-first.theme.dark.color.border.focus → color.blue.dark.600

The raw values these tokens end at are on Primitives › all kinds.

When to use what​

SituationUseNotWhy
Keyboard focusbutton/focus-ring at border-width.focus, with an offsetA thin or faint outlineFocus must be seen by everyone.
The smallest clickable thingsize.control.default (large)Touch-minimum sizeLarge targets help people with motor needs.