Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-6702376

Javadoc HTML accessibility issues in generated HTML by standard doclet (including WCAG 2.0 issues)

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P3 P3
    • 7
    • 6
    • tools

      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.

            bpatel Bhavesh Patel (Inactive)
            dkorbel David Korbel (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: