RFR: 8373679: Link color accessibility issue in dark theme

Nizar Benalla nbenalla at openjdk.org
Fri Jan 23 17:07:22 UTC 2026


On Thu, 22 Jan 2026 15:21:24 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> Please review a workaround for an accessibility issue in the JavaDoc dark theme. The color used for links in the dark theme does not have enough contrast from normal text according to WCAG 2. The workaround adds underlining to links in mixed content in the dark theme to make links easier to recognize. The change is implemented with a single nested CSS rule in the block that defines the dark theme settings.
> 
> Generated documentation can be viewed here: 
> https://cr.openjdk.org/~hannesw/8373679/api.00/java.base/java/lang/package-summary.html
> (java.base module only, change affects dark modse only)
> 
> Compliance of generated docs with WCAG 2 contrast requirements was tested with various A11Y tools.

Marked as reviewed by nbenalla (Committer).

-------------

PR Review: https://git.openjdk.org/jdk/pull/29364#pullrequestreview-3698627961


More information about the javadoc-dev mailing list