JDK-4905786 : Table headings in Javadoc output are not accessible - use
The Version table provides details related to the release that this issue/RFE will be addressed.
Unresolved : Release in which this issue/RFE will be addressed. Resolved: Release in which this issue/RFE has been resolved. Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.
Name: dk106046 Date: 08/13/2003
NOTE: This request is based on a liberal interpretation of the U.S. Federal
Government 508 Standard.
Documentation generated by javadoc has an accessbility problem because table headings are
represented as <td> instead of <th>.
This has an accessbility problem because table headings are represented as <td> instead of <th>,
and as such assistive technologies cannot distinguish headings from other table data.
For any packages, generate javadoc using the javadoc command
For example, from D:\cn131-20020821\src\classes\sov directory run the following command:
javadoc -d e:\docs -sourcepath . java.util javax.swing java.io
Cause of the problem::
<TH> tag is never used in the javadoc. <TD> tag was used instead of <TH> tag.
[This bug is being submitted as a courtesy, in order to maintain uniformity between Sun & IBM JDKs. It has been fixed in IBM JDKs. Please contact ###@###.### if you have questions.]
BugTraq+ Release Management Values
COMMIT TO FIX:
Fixed. Now using <TH> for headings.
This would be a variant of section 508(g) "Row and column headers shall be
identified for data tables" (these are not data tables -- they are
layout tables with headers).
Using <th> would apply to all tables that have headings:
Overview Page (overview-summary.html)
"Java 2 Platform Packages" table (lists all package names)
Package Page (package-summary.html)
"Interface Summary" table
"Class Summary" table
"Exception Summary" table
"Error Summary" table
"Nested Class Summary" table
"Nested classes inherited from class XXX" table
"Field Summary" table
"Fields inherited from class XXX" table
"Packages that use XXX"
"Uses of XXX in java.xxx"
"Deprecated Classes" table
"Deprecated Interfaces" table
Constant Values Page
NOTE: All data on this page is in tables with no borders.
<th> should be applied to the header of each of these tables
Serialized Form Page
"Class XXX extends XXX implements Serializable"
NOTE: All tables on this page are single cell and act as headings.
Table characteristics for single-cell tables are typically
ignored by screen readers.
Could change <td> to <th> if easy to do so, as they are all headings.
Overview Frame (upper-left frame, overview-frame.html)
"Java 2 Platform Std. Ed. 1.4.2"
NOTE: The above heading is in a single-cell table.
The <th> could be applied to it.
The rest of the content ("All Classes" link and "Packages" AND list of
package names) are all in a single-cell table, so should *not* get the
All Classes Frame (lower-left frame, all-classes.html)
NOTE: The heading "All Classes" is not in a table.
The rest of the frame (the list of classes) is in a single-cell table,
so should *not* get the <th> tag.
Package Frame (lower-left frame, package-frame.html)
NOTE: The "java.applet" heading is not in a table.
Each subsequent heading ("Interfaces", "Classes")
AND its content is in a single-cell table, so should *not* get
the <th> tag.
Fixed. Now using <TH> in headings.