|
Quick Lists
|
|
Bug ID:
|
4706779
|
|
Votes
|
0
|
|
Synopsis
|
stddoclet: Add text equivalent of ASCII art in class tree for accessibility
|
|
Category
|
doclet:tbd
|
|
Reported Against
|
1.2
, 1.4.0_00
|
|
Release Fixed
|
1.4.2(mantis)
|
|
State
|
10-Fix Delivered,
request for enhancement
|
|
Priority:
|
4-Low
|
|
Related Bugs
|
4198141
|
|
Submit Date
|
22-JUN-2002
|
|
Description
|
The ASCII class trees need equivalent text.
Priority 1
Section 508 1194.22(a)
A text equivalent for every non-text element shall be provided
(e.g., via "alt", "longdesc", or in element content)
W3C Checkpoint 1.1
http://www.w3.org/TR/WCAG10-CORE-TECHS/#text-equivalent
"Text equivalents mus be provided for every non-text element ...
This includes ASCII art..."
The ASCII art under consideration is the vertical line, horizontal line
and plus sign:
java.lang.Object
|
+--java.lang.String
|
|
Work Around
|
N/A
|
|
Evaluation
|
Important for accessibility.
xxxxx@xxxxx 2002-06-22
There are two ways to resolve this:
- Put a <MAP title="xxx"> element around each piece of ASCII art,
similar to that recommended for grouping links in a navigation bar
- Replace the ASCII art with an image <IMG src="inherit.gif" alt="xxx">
The second approach would also make the appearance better, a long-needed
enhancement.
xxxxx@xxxxx 2002-08-22
> What should the alt text be?
>
> The alt text should make sense when spoken by an accessibility program
> to a non-sighted user in the context of the words before and after it.
> For example, the above would be spoken as:
>
> "java-dot-lang-dot-Object is extended by com-dot-package-dot-Class1"
>
> Unfortunately, this is the reverse of the way we normally speak it.
>
> A) "is extended by" in all cases
> B) Insert different strings for an interface "implemented by" a class
> compared to an interface "extended by" an interface,
> and a class "extended by" a class.
> C) Drop the word "is" in proposal A or B: "extended by", "implemented by"
> D) Other proposals?
I vote C. I'd *definitely* distinguish extended and implemented. I agree
that the "is" seems unnecessary, but I could go either way on it.
Regards,
xxxxx@xxxxx
Conclusion for alt text:
interface "implemented by" class
interface "extended by" interface
class "extended by" class
xxxxx@xxxxx 2002-08-27
Decided to create a resources directory in the destination directory
to hold non-HTML files that come from the source tree resources directory,
such as inherit.gif and stylesheet.css. Equivalent to what is used in
the MIF Doclet.
xxxxx@xxxxx 2002-08-29
|
|
Comments
|
PLEASE NOTE: JDK6 is formerly known as Project Mustang
|
|
|
 |