-
Bug
-
Resolution: Duplicate
-
P3
-
6
-
generic
-
generic
Licensee observes the HTML generated by the Javadoc tool does not meet the
requirements of the Web Content Accessibility Guidelines 2.0 standard:
http://www.w3.org/TR/WCAG20/
Here are some accessibility problems believed to be found so far. Note that
this is not an exhaustive list - there are likely to be more problems.
1. The value of the LANG attribute must be set to one of the ISO 639
language codes.
2. DL tag does not have DT and DD tags nested.
3. Tables should have captions, summary information
4. Table columns should be labeled.
5. Bold characters should be <strong>
6. <p> seems to be used inconsistently
Known failing WCAG 2.0 checkpoints:
1. Using the summary attribute of the table element to give an overview
of data tables
2. Using semantic elements to mark up structure
3. Using ol, ul and dl for lists
4. Using the lang attribute to identify the language of the page
5. <code> and <pre> are not semantic tags
There are other, more general issues too. For example, the generated HTML contains tags that are opened and not closed, incorrect usage of <dl> tags, and other issues. For example:
<DL>
<DT><PRE>public interface <B>JavaReference</B></DL>
</PRE>
Note how the <PRE> tag starts inside the <dl> and ends outside it.
requirements of the Web Content Accessibility Guidelines 2.0 standard:
http://www.w3.org/TR/WCAG20/
Here are some accessibility problems believed to be found so far. Note that
this is not an exhaustive list - there are likely to be more problems.
1. The value of the LANG attribute must be set to one of the ISO 639
language codes.
2. DL tag does not have DT and DD tags nested.
3. Tables should have captions, summary information
4. Table columns should be labeled.
5. Bold characters should be <strong>
6. <p> seems to be used inconsistently
Known failing WCAG 2.0 checkpoints:
1. Using the summary attribute of the table element to give an overview
of data tables
2. Using semantic elements to mark up structure
3. Using ol, ul and dl for lists
4. Using the lang attribute to identify the language of the page
5. <code> and <pre> are not semantic tags
There are other, more general issues too. For example, the generated HTML contains tags that are opened and not closed, incorrect usage of <dl> tags, and other issues. For example:
<DL>
<DT><PRE>public interface <B>JavaReference</B></DL>
</PRE>
Note how the <PRE> tag starts inside the <dl> and ends outside it.
- duplicates
-
JDK-6851834 Javadoc doclet needs a structured approach to generate the output HTML.
- Closed
- relates to
-
JDK-6786028 Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - Bold tags should be strong.
- Closed
-
JDK-6786682 Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute.
- Closed
-
JDK-6786688 Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - Table must have captions and headers
- Closed
-
JDK-6786690 Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - DL tag and nesting issue.
- Closed