JDK-4636667 : stddoclet: Use



in proper sequence for accessibility

  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2002-02-12
  • Updated: 2014-05-05
  • Resolved: 2002-09-28
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.

To download the current JDK release, click here.
1.4.2 mantisFixed
Sections 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
     "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.

CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mantis FIXED IN: mantis INTEGRATED IN: mantis mantis-b03

PUBLIC COMMENTS 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 ###@###.### 2002-09-05

EVALUATION Important and easy to do for accessibility. I only affects the overview-summary page, which has <H2> but should have <H1>. ###@###.### 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% } ###@###.### 2002-09-04