Skip to content

Commit c077f6d

Browse files
authored
Update avoid-generic-link-text-counter.md
1 parent 595f5a3 commit c077f6d

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

docs/rules/accessibility/avoid-generic-link-text-counter.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,14 @@
22

33
## Rule Details
44

5-
Avoid setting generic link text like, "Click here", "Read more", and "Learn more" which do not make sense when read out of context. Screen reader users often tab through links on a page to quickly find content without needing to listen to the full page. When link text is too generic, it becomes difficult to quickly identify the destination of the link.
5+
Avoid setting generic link text like, "Click here", "Read more", and "Learn more" which do not make sense when read out of context.
6+
7+
Screen reader users often tab through links on a page to quickly find content without needing to listen to the full page. When link text is too generic, it becomes difficult to quickly identify the destination of the link. While it is possible to provide a more specific link text by setting the `aria-label`, this results in divergence between the label and the text and is not an ideal, future-proof solution.
8+
9+
Additionally, generic link text can also problematic for heavy zoom users where the link context is out of view.
10+
11+
Ensure that your link text is descriptive and the purpose of the link is clear even when read out of context of surrounding text.
12+
Learn more about how to write descriptive link text at [Access Guide: Write descriptive link text](https://www.accessguide.io/guide/descriptive-link-text)
613

714
## Resources
815

0 commit comments

Comments
 (0)