Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 36548

Summary:	Help frames accessibility issues
Product:	[Eclipse Project] Platform	Reporter:	Konrad Kolosowski <konradk>
Component:	User Assistance	Assignee:	Konrad Kolosowski <konradk>
Status:	RESOLVED FIXED	QA Contact:
Severity:	major
Priority:	P1	CC:	andrea_covas, birsan, dan.scott, dejan, eddie.angel
Version:	2.1	Keywords:	accessibility
Target Milestone:	2.1.1
Hardware:	PC
OS:	Windows 2000
Whiteboard:

Description Konrad Kolosowski

2003-04-15 21:45:41 EDT

Jaws shows 14 frames when viewing help.  It is not clear which frames contain 
readable contents and which are used purely for layout.  The names of the 
frames are sometimes criptic like "NavFrame".

Comment 1 Konrad Kolosowski

2003-04-15 22:10:59 EDT

I identified the following problems with frames:

1.  Frame element is missing a title attribute, and only provides non 
translatable name attribute.
2.  Many frames that are needed are not displayed in a list of frames because 
they do not have unique name attributes.  For example there is only one tool 
bar frame since all views (toc, search, bookmarks, links, contents) have a 
toolbar with the same name "ToolbarFrame".
3.  Help contains 6 hidden frames needed by implementation , There is 1 "temp" 
frame, and 5 "liveHelpFrame" frames.  Only one "liveHelpFrame" is needed.
4.  Out of the 6 hidden frames only one ("temp") frame is listed in JAWS.  It 
is desired that none of these frames is listed.  The "liveHelpFrame" frames are 
not included included due to a style="visibility:hidden" attribute.  The "temp" 
frame is shown in the list because its hidden style is applied by style that is 
defined in a class and class="hidden" attribute is applied.
5.  Frames that only contain nested frames and nothing else, are shown in the 
list of frames.  Ideally they should not be listed, and minimally a title 
should indicate that the frame contains other frames only.

The first two items are required to meet accessibility guidelines.  This bug 
needs to be fixed for 2.1.1.  Please approve.

Comment 2 Konrad Kolosowski

2003-04-15 22:13:33 EDT

I have forgot to mention that adding titles to the frames will require new 
strings in the properties.  To have the titles show in other languages, the 
properties file will need to be re-translated for 2.1.1.

Comment 3 Dorian Birsan

2003-04-15 23:40:50 EDT

+1

The fixes are important and very low risk, they should be put in 2.1.1

Comment 4 Dejan Glozic

2003-04-16 08:52:56 EDT

+1

Comment 5 Konrad Kolosowski

2003-04-17 11:24:19 EDT

Fixed in for both 2.1 and 2.1.1.

Comment 6 Konrad Kolosowski

2003-07-18 14:40:32 EDT

*** Bug 37423 has been marked as a duplicate of this bug. ***

Comment 7 Konrad Kolosowski

2004-04-19 10:47:59 EDT

*** Bug 53190 has been marked as a duplicate of this bug. ***