RFR: JDK-8287674: CSS improvements for summary lists

Jonathan Gibbons jjg at openjdk.java.net
Wed Jun 1 18:23:34 UTC 2022


On Wed, 1 Jun 2022 16:16:33 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> This is a refinement of CSS styles mostly in the deprecated and new API pages.
> 
>  - Provide a two-row table view for the new sortable three-column tables
>  - Make sure no line wraps are inserted between a checkbox and its label
>  - Slightly increase the line height of the check box row to make it easier to use when wrapped
>  - Define the overflow of summary table cells as "auto" which makes them scrollable if necessary

Approved with suggestion for future.

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/DeprecatedListWriter.java line 94:

> 92:                         : Text.of(release);
> 93:                 HtmlId htmlId = HtmlId.of("release-" + releaseIndex);
> 94:                 tabs.add(new HtmlTree(TagName.WBR)).add(HtmlTree.LABEL(htmlId.name(),

Possible (future?) candidate for a static factory method.
Do we want to formally transition to always using static factory methods, and make the `new HtmlTree` constructors private?

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

Marked as reviewed by jjg (Reviewer).

PR: https://git.openjdk.java.net/jdk/pull/8975


More information about the javadoc-dev mailing list