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

[Andy Goryachev]

On Fri, 20 Feb 2026 21:08:14 GMT, Andy Goryachev <angorya at openjdk.org> wrote:

> Addressing the accessibility issues in JavaFX CSS Reference Guide and Introduction to FXML documents:
> 
> [JDK-8378306](https://bugs.openjdk.org/browse/JDK-8378306) In JavaFX CSS Reference Guide, a `<ul>` element must appear within an `<li>` element
> [JDK-8378308](https://bugs.openjdk.org/browse/JDK-8378308) In JavaFX CSS Reference Guide, <textarea> elements do not contain a label
> [JDK-8378309](https://bugs.openjdk.org/browse/JDK-8378309) In JavaFX CSS Reference Guide and Introduction to FXML, there are color contrast issues
> [JDK-8378310](https://bugs.openjdk.org/browse/JDK-8378310) In JavaFX CSS Reference Guide and Introduction to FXML, a "Skip to Main Content" link doesn't exist
> [JDK-8378307](https://bugs.openjdk.org/browse/JDK-8378307) In JavaFX CSS Reference Guide, some tables don't use the scope attribute or the <caption> element
> 
> For ease of reviewing, the first 5 commits correspond to individual tickets.
> 
> Most of the changes are trivial, but for [JDK-8378307](https://bugs.openjdk.org/browse/JDK-8378307) I decided to replace the table with `<ul>` list used elsewhere in similar situations.
> 
> In [JDK-8378308](https://bugs.openjdk.org/browse/JDK-8378308) the `<textarea>`s were made read-only because obviously.

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.

An alternative would be to provide the `summary` attribute.  What should be the summary text in these three cases?

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

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