JDK-4852280 : IE displays unnecessary horizontal scroll bar in frameset in J2SE API spec
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.1
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: windows_98
  • CPU: x86
  • Submitted: 2003-04-22
  • Updated: 2014-05-05
  • Resolved: 2003-11-23
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.
Other
5.0 b30Fixed
Description
Name: rmT116609			Date: 04/22/2003

DESCRIPTION OF THE PROBLEM :
 
http://java.sun.com/j2se/1.3/docs/api/index.html
http://java.sun.com/j2se/1.4.1/docs/api/index.html
http://java.sun.com/j2se/1.4.2/docs/api/index.html


The index-file of the docs is a frameset. But the right frame is too wide to fit in the window.

...
<FRAMESET cols="20%,80%">
<FRAMESET rows="30%,70%">
<FRAME src="overview-frame.html" name="packageListFrame" >
<FRAME src="allclasses-frame.html" name="packageFrame">
</FRAMESET>
<FRAME src="overview-summary.html" name="classFrame">
</FRAMESET>
...

So it is better like this:

...
<FRAMESET cols="20%,80%">
<FRAMESET rows="30%,70%">
<FRAME src="overview-frame.html" name="packageListFrame" >
<FRAME src="allclasses-frame.html" name="packageFrame">
</FRAMESET>
<FRAME src="overview-summary.html" name="classFrame"
scrolling="yes">
</FRAMESET>
...


The the output from typing `diff index.html index.html.new
` at the DOS prompt looks like this:

15c15
< <FRAME src="overview-summary.html" name="classFrame">
---
> <FRAME src="overview-summary.html" name="classFrame"
scrolling="yes">


STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Just open the index-file. It does not need any further explanation.
Please see the attached "doc.jpg" file.

REPRODUCIBILITY :
This bug can be reproduced always.
(Review ID: 166758) 
======================================================================
Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: tiger tiger-beta FIXED IN: tiger-beta INTEGRATED IN: tiger-b30 tiger-beta
14-06-2004
WORK AROUND The horizontal scroll bar will go away if you change api/index.html from this: <FRAME src="overview-summary.html" name="classFrame"> to this: <FRAME src="overview-summary.html" name="classFrame" scrolling="yes"> The scrolling="yes" attribute forces the vertical scroll bar to appear (even if the content completely fits in the frame) which causes Internet Explorer to layout the vertical scroll bar before it starts laying out the page, thereby rendering the document inside the area bounded by the vertical scroll bar (instead of behind it), causing the horizontal scroll bar to disappear. Voila! No more horizontal scrolling needed.
11-06-2004
PUBLIC COMMENTS Fixed. ###@###.### 2003-11-15
15-11-2003
EVALUATION This is a case that does not appear to have been fixed by the following bug fix, where this bug was fixed for Netscape/Mozilla: 4749453: Displays unnecessary horizontal scroll bars - invalid HTML DOCTYPE One property of this bug is that no matter how wide you make the window, it's never wide enough to make the entire width of the document display and for the horizontal scroll bar to disappear. Changed synopsis from: Frameset of Java 2 Platform API Specification to: IE displays unnecessary horizontal scroll bar in frameset in J2SE API spec ###@###.### 2003-04-22 Upon further research, this is a bug in Internet Explorer that is not present in Netscape or Mozilla. Internet Explorer frame bug When Internet Explorer displays a frameset document, if one of the frames has too much vertical content to fit in its space on the screen, as expected, a vertical scrollbar appears. Unfortunately, IE considers the rectangular area *behind* the scrollbar as space for text layout. The result is that the document lays out behind the scroll bar, and in a stunning example of doublethink, IE then says "Whoops, the layout is running off the right side of the page" and also displays a horizontal scrollbar. Even resizing the frame manually won't get rid of the horizontal scrollbar (as long as the document still wants more vertical space than is available to it). - Paraphrased from ###@###.### 24 October 2002 Three possible solutions: 1) Ignore the problem and wait for MS to fix the problem However, I could not find this bug on microsoft.com in knowledge base and don't know how to submit bugs to MS. 2) Remove the DOCTYPE declaration from the top of the index.html file. The effect is apparently to throw IE into "quirks" mode, which perversely seems to behave better in this case than "standards" mode. 3) Turn on scrolling="yes" attribute, which forces the vertical (but not horizontal) scroll bar to appear and forces IE to realize its area is not available for text layout. If all documents are longer than one screen, it won't matter that the vertical scroll bar is always present. However, if any page fits fully on the screen, the scroll be will still be present (though the scroll arrows will not appear). ###@###.### 2003-04-23 One symptom of this problem is that no matter how wide you make the window, as long as it is showing frames, if the vertical scroll bar is showing in the right frame, the horizontal scroll bar will also show. You can see that this problem is caused by the vertical scroll bar by going to a page whose content fits entirely in the frame: Click java.lang Click Cloneable Make the window tall enough so the vertical scroll bar disappears. This causes the horizontal scroll bar to disappear. ###@###.### 2003-08-02 Fixed using recommendation. ###@###.### 2003-11-15
02-08-2003