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

[Michael Strauß]

On Fri, 20 Feb 2026 21:46:07 GMT, Andy Goryachev <angorya 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.

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

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