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

[Kevin Rushforth]

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.

I took a stab at providing a caption, if we end up reverting the change to bulleted lists in the easing functions, and instead make the existing tables accessible.

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

> 1896:     <p class="grammar">ease | ease-in | ease-out | ease-in-out | cubic-bezier(<a href="#typenumber" class="typelink"><number [0,1]></a>, <a href="#typenumber" class="typelink"><number></a>, <a href="#typenumber" class="typelink"><number [0,1]></a>, <a href="#typenumber" class="typelink"><number></a>)</p>
> 1897:     <p>The values have the following meaning:</p>
> 1898:     <table style="margin-left: 40px;">

A reasonable caption might be:


<caption>Cubic Bézier Easing Functions</caption>

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

> 1927:     <p class="grammar">where <step-position> = jump-start | jump-end | jump-none | jump-both | start | end</p>
> 1928:     <p>The values have the following meaning:</p>
> 1929:     <table style="margin-left: 40px;">

A reasonable caption might be:


<caption>Step Easing Functions</caption>

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

> 1990:     <p class="grammar">-fx-ease-in | -fx-ease-out | -fx-ease-both</p>
> 1991:     <p>The values have the following meaning:</p>
> 1992:     <table style="margin-left: 40px;">

A reasonable caption might be:


<caption>SMIL 3.0 Easing Functions</caption>

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

PR Review: https://git.openjdk.org/jfx/pull/2082#pullrequestreview-3834538487
PR Review Comment: https://git.openjdk.org/jfx/pull/2082#discussion_r2835412273
PR Review Comment: https://git.openjdk.org/jfx/pull/2082#discussion_r2835413100
PR Review Comment: https://git.openjdk.org/jfx/pull/2082#discussion_r2835414643