RFR: 8378366: Accessibility issues in CSS Reference Guide and Introduction to FXML

[Kevin Rushforth]

On Fri, 20 Feb 2026 22:58:55 GMT, Michael Strauß <mstrauss at openjdk.org> wrote:

> > The table is not accessible (we probably should not use tables for formatting anyway), and it is more consistent with the rest of the document.
> 
> I'd say that this is semantically more like a table than it is like a list. The left column contains the keywords, and the right column contains the descriptions.
> 
> > An alternative would be to provide the `summary` attribute. What should be the summary text in these three cases?
> 
> `summary` has been [deprecated](https://html.spec.whatwg.org/multipage/obsolete.html#attr-table-summary) for some 15 years. We could use `aria-label` instead.

We use `<caption>` for all HTML tables elsewhere in this page and others (e.g., the javafx.media package docs).

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

PR Comment: https://git.openjdk.org/jfx/pull/2082#issuecomment-3937552976