Bug ID: JDK-8253117 Replace HTML tables in javadoc summaries with CSS grid elements

Versions (Unresolved/Resolved/Fixed)

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 16
16 b20Fixed

Javadoc uses HTML tables for various summaries such as module, package, class, and various member summaries. While HTML tables where the only way to display information in a grid-like structure for a long time, current web browsers support a more modern and flexible technology called CSS Grid Layout[1][2].

[1]: https://www.w3.org/TR/css-grid-1/
[2]: https://developer.mozilla.org/de/docs/Web/CSS/CSS_Grid_Layout

CSS Grid Layout provides flexibility compared to HTML tables by not requiring the layout of grid elements to be encoded in the HTML reflecting the grid's structure or even using specific element types. The layout of grid elements is defined fully in CSS. This allows us to simplify the structure of the HTML we generate and apply different layout strategies depending on the current browsing environment such as the size of the display or the browser window.

CSS Grid Layout is well supported in modern browsers[3].

[3]: https://caniuse.com/css-grid

Duplicate :	JDK-8248869 - Consider using definition lists instead of tables for summaries.
Relates :	JDK-8232439 - Revisit/review column widths in javadoc tables
Relates :	JDK-8288900 - Add structural HTML elements for table rows