SeleniumHQ/seleniumhq.github.io

Text on Selenium site is hard to read due to low visual contrast

Chiusa

#2479 aperta il 12 set 2025

 (1 commento) (0 reazioni) (0 assegnatari)HTML (1015 fork)batch import
bughacktoberfestneeds-triaging

Metriche repository

Star
 (712 stelle)
Metriche merge PR
 (Merge medio 2g 4h) (8 PR mergiate in 30 g)

Descrizione

What happened?

On the page https://www.selenium.dev/documentation, the main text is displayed in a thin gray font on a white background. • Sidebar text uses color rgba(111,117,122,0.75) on a white background, resulting in a contrast ratio of 2.92:1, which is below WCAG AA minimum (4,5:1) • Main text uses the same RGB values but with full opacity (alpha = 1), resulting in a contrast ratio of 4.66:1, which meets WCAG AA, but it is very close to threshold (4.5:1). Also, taking into account the antialiasing and think stroke, the most pixels are lighter than the base color (1st screenshot), so the result color contrast ratio will be lower than 4.5:1. Actually WCAG contrast calculations do not account for anti-aliasing, font weight, so text that meets the numeric contrast ratio may still appear visually weak or hard to read Additionally, the combination of light background with thin gray thin text+ anti-aliasing visually overloads the eyes. I always feel discomfort when try to read the documentation on my external monitor.

Guida contributor