Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8253117

Replace HTML tables in javadoc summaries with CSS grid elements

    XMLWordPrintable

    Details

    • Type: Enhancement
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: 16
    • Fix Version/s: 16
    • Component/s: tools
    • Labels:
      None

      Description

      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

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              hannesw Hannes Wallnoefer
              Reporter:
              hannesw Hannes Wallnoefer
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: