Technologies that support Accessible Rich Internet Applications (WAI-ARIA).
This technique relates to:
- Success Criterion 2.4.4: Link Purpose (In Context) (Sufficient as a way to meet an unwritten technique)
- Success Criterion 2.4.9: Link Purpose (Link Only) (Sufficient)
The objective of this technique is to describe the purpose of a link using the
aria-label attribute. The
aria-label attribute provides a way to place a descriptive text label on an object, such as
a link, when there are no elements visible on the page that describe the object. If
descriptive elements are visible on the page, the
aria-labelledby attribute should be used instead of
aria-label. Providing a descriptive text label lets a user distinguish the link from links in
the Web page that lead to other destinations and helps the user determine whether
to follow the link. In some assistive technologies the
aria-label value will show in the list of links instead of the actual link text.
Per the Accessible Name and Description Computation and the HTML to Platform Accessibility APIs Implementation Guide, the
aria-label text will override the text supplied within the link. As such the text supplied will
be used instead of the link text by AT. Due to this it is recommended to start the
text used in
aria-label with the text used within the link. This will allow consistent communication between
Resources are for information purposes only, no endorsement implied.
For link elements that use
- Check that the value of the
aria-labelattribute properly describes the purpose of the link element.
- #1 is true.