-
Enhancement
-
Resolution: Fixed
-
P3
-
8
-
b108
-
generic
-
generic
-
Verified
SYNOPSIS
--------
Accessibility in Javadoc: hyperlinks should contain text or an image with alt text
OPERATING SYSTEMS
-----------------
ALL
PATCH BASE
---------
See attached webrev for code changes and jtreg testcase, based on JDK 8 (b51).
FULL JDK VERSIONS
-----------------
All
DESCRIPTION from LICENSEE
-------------------------
Assistive technologies must be able to gather information about user interface controls in page content. Without this information, users are unable to determine the purpose of a link. Text within the <a> element, or the 'alt' attribute on an image of the link, should be employed to convey this information to users.
Refer to WCAG 2.0 Technique H30:
http://www.w3.org/WAI/GL/WCAG20/WD-WCAG20-TECHS/H30
REPRODUCTION INSTRUCTIONS
-------------------------
For any packages, generate javadoc using the javadoc tool. For example:
javadoc -d e:\docs -sourcepath . java.util javax.swing java.io
Example current HTML:
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
Example expected HTML:
<div class="skip"><a href="#skip-navbar_top" title="Skip navigation links">Skip navigation links</a></div>
Related guideline references:
WCAG 2.0 checkpoint 1.1.1
WCAG 2.0 checkpoint 2.1.1
WCAG 2.0 checkpoint 2.4.4
WCAG 2.0 checkpoint 2.4.9
WCAG 2.0 checkpoint 4.1.2
WORKAROUND
----------
NONE
--------
Accessibility in Javadoc: hyperlinks should contain text or an image with alt text
OPERATING SYSTEMS
-----------------
ALL
PATCH BASE
---------
See attached webrev for code changes and jtreg testcase, based on JDK 8 (b51).
FULL JDK VERSIONS
-----------------
All
DESCRIPTION from LICENSEE
-------------------------
Assistive technologies must be able to gather information about user interface controls in page content. Without this information, users are unable to determine the purpose of a link. Text within the <a> element, or the 'alt' attribute on an image of the link, should be employed to convey this information to users.
Refer to WCAG 2.0 Technique H30:
http://www.w3.org/WAI/GL/WCAG20/WD-WCAG20-TECHS/H30
REPRODUCTION INSTRUCTIONS
-------------------------
For any packages, generate javadoc using the javadoc tool. For example:
javadoc -d e:\docs -sourcepath . java.util javax.swing java.io
Example current HTML:
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
Example expected HTML:
<div class="skip"><a href="#skip-navbar_top" title="Skip navigation links">Skip navigation links</a></div>
Related guideline references:
WCAG 2.0 checkpoint 1.1.1
WCAG 2.0 checkpoint 2.1.1
WCAG 2.0 checkpoint 2.4.4
WCAG 2.0 checkpoint 2.4.9
WCAG 2.0 checkpoint 4.1.2
WORKAROUND
----------
NONE