color-contrastText has too little contrast
Text that is too close in colour to its background is hard or impossible to read. Normal text needs a contrast ratio of at least 4.5:1 and large text 3:1; darken the text or lighten the background.
Who it hurts
People with low vision or colour-vision differences, older readers, and anyone on a phone in sunlight.
Light grey on white (#a3a3a3 on #fff is 2.5:1) is the classic case, along with white text on bright brand colours and text over photos.
How to fix it
Pick your stack. Review every change before you ship it.
Before
<p style="color:#a3a3a3">Free shipping over €50</p>After
<p style="color:#595959">Free shipping over €50</p>#595959 on white is 7:1.
Check it by hand too
Automated tools can’t judge text over images or gradients. Check those by hand with a contrast checker, including hover and focus states.
Automated checks find a large share of accessibility problems, but not all of them. Passing this check does not on its own make a page compliant.
WCAG reference
- 1.4.3 Contrast (Minimum) (Level AA). Understanding 1.4.3