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

[Kevin Rushforth]

On Mon, 23 Feb 2026 18:41: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.
>> 
>> In [JDK-8378308](https://bugs.openjdk.org/browse/JDK-8378308) the `<textarea>`s were made read-only because obviously.
>> 
>> Additional issues that came about during the review (both accessibility- and code-):
>> 
>> - fixed `BoderPane` typo
>> - added missing `scope` attribute to `<th>` 
>> - moved inline style in the "layout" table to CSS
>> - fixed shaded table cell contrast
>
> Andy Goryachev has updated the pull request incrementally with one additional commit since the last revision:
> 
>   left 40

modules/javafx.graphics/src/main/docs/javafx/scene/doc-files/cssref.html line 4613:

> 4611:         <tr>
> 4612:         <th class="propertyname" scope="row">CSS Pseudo-class</th>
> 4613:             <th scope="col">Comments</th scope="col">

Typo. There shouldn't be any attributes on the `</th>` closing tag.

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

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