Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4636667
Votes 0
Synopsis stddoclet: Use <H1>, <H2>, <H3> in proper sequence for accessibility
Category doclet:tbd
Reported Against 1.4
Release Fixed 1.4.2(mantis)
State 10-Fix Delivered, request for enhancement
Priority: 4-Low
Related Bugs
Submit Date 12-FEB-2002
Description
Fixed by changing overview-summary.html page to:

<H1>
Document Title
</H1>

and adding this to stylesheet.css 

/* Headings */
h1 { font-size: 145% }

Regression test at <ws>/test/com/sun/javadoc/AccessH1/AccessH1.java

 xxxxx@xxxxx  2002-09-05Sections should be introduced with the HTML heading elements (H1-H6). 

  Priority 2
  NOT a Section 508 requirement, but is a W3C recommendation
  W3C Checkpoint 3.5
     http://www.w3.org/TR/WCAG10-HTML-TECHS/#document-headers
     "Sections should be introduced with the HTML heading elements (H1-H6)"
      H2 elements should follow H1 elements, H3 elements should follow H2 
      elements, etc. Content developers should not "skip" levels 
      (e.g., H1 directly to H3)."

Change the header elements so they appear in sequence <H1>, <H2>, <H3>.  
As of 1.4.0, <H2> appears on the Overview page, each package page
contains <H2>, and each class page contains <H2> and <H3>.

This can be fixed by changing the overview page to <H1>, as that
contains the title of the entire document.

Because doing this will increase the size of the overview title font, 
it is important to also add a style definition to set its font sizes 
to be similar in size to the existing Javadoc output.
Work Around
N/A
Evaluation
Important and easy to do for accessibility. I only affects
the overview-summary page, which has <H2> but should have <H1>.
 xxxxx@xxxxx  2002-02-12

If we replace <H2> with <H1> on the overview page, the title
will be larger than it was, and some title will not fit on 
the line as they had previously.  The default <H1> is too large
of a font for the title.  

To get the same size font on Mozilla 1.0 and Internet Explorer 6 
requires setting the font size of H1 to 145% of the body font.
The font size is ignored by Netscape 4.x, so will just have to
stay larger in that browser.  So use this:

<H1 style="font-size: 140%">
Document Title
</H1>

Or, better yet, set the size in stylesheet.css, since there will
be only one occurrence of <H1>:

/* Headings */
h1 { font-size: 145% }

 xxxxx@xxxxx  2002-09-04
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang