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

[Kevin Rushforth]

On Fri, 20 Feb 2026 23:06:23 GMT, Alexander Zuev <kizune 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.
>
> modules/javafx.fxml/src/main/docs/javafx/fxml/doc-files/introduction_to_fxml.html line 46:
> 
>> 44: <h1>Introduction to FXML</h1>
>> 45: <p>Release: JavaFX @FXVERSION@</p>
>> 46: <p class="subtitle">Last updated: 01 May 2017</p>
> 
> I guess we are not changing "Last updated" since we do not change the content of the document but the formatting and metadata? Just making sure i understand the scope here.

Correct.

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

PR Review Comment: https://git.openjdk.org/jfx/pull/2082#discussion_r2835432101