UI DESIGN LAB
  • Home
  • Community
  • Library
  • Knowledge
  • Docs
ZHLogin
Back to knowledge
Typography Color Accessibility

Legibility Contrast

Text contrast must serve reading first, especially for small text, disabled states, notes, and button labels.

contrastaccessibilityreadability

Design Principle

Low contrast turns polish into unusability, especially on mobile and in difficult lighting.

Principle Low contrast turns polish into unusability, especially on mobile and in difficult lighting.

Design action Keep body and key labels high contrast; disabled states may reduce saturation but must remain recognizable, and button text must be readable on its surface.

Examples Positive example: Buttons, tags, cards, and form feedback containing text. Counterexample: Gray text sits on gray surfaces.

Apply when Buttons, tags, cards, and form feedback containing text. Light and dark surfaces alternate.

Source notes Source note: Synthesized from W3C WCAG 2.2, Apple Accessibility, IBM Carbon Accessibility, and accessibility practices in major design systems.

Agent Directive

Keep body and key labels high contrast; disabled states may reduce saturation but must remain recognizable, and button text must be readable on its surface.

Apply When

  • Buttons, tags, cards, and form feedback containing text.
  • Light and dark surfaces alternate.

Avoid

  • Gray text sits on gray surfaces.
  • Colored buttons have insufficient text contrast.

Knowledge Metadata

Category
Typography Color Accessibility
Quality
82%
Version
v1
Published
6/6/2026