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

[Alexander Zuev]

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.

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

> 240:                 margin-right:1em;
> 241:             }
> 242: 			.skip-nav {

Because of use of tabs (and i think in your IDE tabstep is set to 4) in vi or other plain text editors the formatting looks really off.

<img width="406" height="246" alt="Image" src="https://github.com/user-attachments/assets/97e47b58-7f7a-4c5a-bbf1-2de0fa6b5722" />

And that is exactly why i hate using tabs for indentation.

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

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