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

[Andy Goryachev]

On Sat, 21 Feb 2026 00:06:21 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.
>
> Andy Goryachev has updated the pull request incrementally with two additional commits since the last revision:
> 
>  - table summary
>  - Revert "8378307 tables"
>    
>    This reverts commit c6e39d251210e36d4b908015bd243e41ce143f41.

the tables are back, baby!

`<rant>`
We should be generating these documents instead of maintaining HTML by hand.  Only then the generated docs can follow the style book du jour, the latest accessibility tech, and produce consistent output across the site.
`</rant>`

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

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