AVT- Hyperlinks must contain link text or an image with alt text
Summary
For hyperlinks, use link text within the element, or add the alt attribute to an image of the link.
Steps to reproduce
GitLab->Help
What is the expected correct behavior?
Assistive technologies must be able to gather information about user interface controls in page content. Providing the role, state, and value information for all user interface controls helps to ensure compatibility with assistive technologies used by people with disabilities. Without proper link information, users are unable to determine the purpose of a link.
Possible fixes
Before investigating this issue, resolve any errors related to invalid IDs.
- Identify the
<a>element (anchor or hyperlink) that caused the error. - Add appropriate link text if the hyperlink is a common format without an image.
- Verify the
<img>element contains the alt attribute with an appropriate descriptive value if the hyperlink contains an image.
For example:
This example shows a hyperlink containing an image with alternative text:
<a title="Print this page" href="print.htm"><img src="img.png" alt="Print this page"></a>
This example shows a hyperlink with link text:
<a href="routes.html">Optional travel routes for your desired trip</a>
Relevant screenshots
-
[GitLab Help Homepage] (All htag {h1~h6} content in Help Documentation page withaelement have this problem)
- image
-
[GitLab Help - All subpages of Help Documentation have this same problem] - https://gitlab.com/help/
@sharonchen @carmacleod
gitlab-ce2677490 gitlab-ce2278648
Edited by Taurie Davis
