[OpenJDK 2D-Dev] [13] Review Request: 8225372 accessibility errors in tables in java.desktop files

Sergey Bylokhov Sergey.Bylokhov at oracle.com
Wed Jun 12 05:29:41 UTC 2019

Please review the fix for JDK 13.

Bug: https://bugs.openjdk.java.net/browse/JDK-8225372
Fix: http://cr.openjdk.java.net/~serb/8225372/webrev.00
Doc: http://cr.openjdk.java.net/~serb/8225372/docs/api/java.desktop/module-summary.html

In the fix, some(most) of the issues which were reported by the accessibility checker were fixed.

Changes description:

  - In the simplest case, the "scope=col/row" attribute was added to the tables:

  - The tables which are used for a layout were replaced by the <div>.(In fact, this is just emulation of <figure>):

  - Some tables do not have the meaningful cell to be row header, so I have added an additional column "index" and use it cells as row header:

  - In one place I have added a special role to the table "role=presentation" because the table was used just for layout and its content can be read without information about this table:

  - In some cases I have dropped the table, and replace it by the list of elements:
      New: http://cr.openjdk.java.net/~serb/8225372/docs/api/java.desktop/javax/print/attribute/standard/Finishings.html
      Old: https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/print/attribute/standard/Finishings.html

Note that I cannot fix two reported issues:
    Take a look to the "Common dialog" and "HTML Content of example above" on the links below:

I tried to mark these tables as "role=presentation" or "aria-hidden=true", but it does not work because Javadoc tool generates HTML4 and these attributes are supported by the HTML5.

Best regards, Sergey.

More information about the 2d-dev mailing list