On Fri, 20 Feb 2026 21:08:14 GMT, Andy Goryachev <[email protected]> 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.

Visually, I also like the table format, although I note that keeping it will 
require the following to make the table accessible:

1. A `<caption>` tag with a summary for each table
2. A header row (with each entry in that row as a `<th scope="col">`). This one 
should be easy: "Easing Function" and "Description" would be reasonable column 
headers in the header row.
3. Changing the first item of each row (the keyword) from `<td ...` to `<th 
scope="row" ...`

@mstr2 Do you have a good summary in mind for the needed `<caption>` ?

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

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

Reply via email to