JDK-8199893 : the javadoc tool generates pages with a low constrast
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 11
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2018-03-20
  • Updated: 2018-06-11
  • Resolved: 2018-06-06
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 11
11 b17Fixed
Related Reports
Relates :  
JDK-8199176 - Accessibility issues in java.base docs
Description
The javadoc tool translates the @link tag, such as {@link java.util.Locale} into a html hyperlink that has a low constrast. The following is an example:

docs/api/java.base/java/time/chrono/HijrahChronology.html
<code>Locale</code> Element has insufficient color contrast of 4.35 (foreground color: #4a6782- background color: #dddddd- font size: 10.5pt- font weight: bold). Expected contrast ratio of 4.5:1 html > body > [role="main"] > .contentContainer > .description > ul > li > .block > table > thead > tr > th:nth-child(3) > a > code
Comments
This looks like a general problem with links in table headers. The short-term workaround would be to unlink the Locale word in the header (which would be a simple edit of the API docs) (If we had page-specific stylesheets we could address it there, but by itself, this issue is not sufficient motivation.) The long-term solution is to figure out how to better solve this in the main stylesheet.
18-04-2018