Give list links context from their list item
Download PDF is a fine link when the list item around it reads Annual report 2025, Download PDF, 2 MB. W3C lists H77 as sufficient for 2.4.4 Link Purpose in Context, where the context in question is the enclosing list item. Two conditions decide whether it applies. The list item has to be the nearest block-level ancestor, so a link buried in a paragraph inside a list item does not inherit the item's context. And the words that complete the meaning should come before the link rather than after it, because somebody reading forward needs the subject before they are asked to act. Self-sufficient link text is still the stronger build, and W3C says so on the same page.
How we find it in an audit
A scanner gives us the repeated generic link text and stops there, because it cannot judge whether the item around a link rescues it. So we pull the links list in a screen reader, mark every entry that means nothing standing alone, then read just that one list item to see whether the ambiguity clears.
How affected users experience it
Read in order, this works. The item arrives whole and the link makes sense in it. The cost lands on the other way people read, which is the links list, where only the link's own words survive. A downloads page turns into Download, Download, Download, and every one of them costs a trip back into the page to find out which report it was.
Passes vs. fails
Passes
<li>Annual report 2025 <a href="/r25.pdf">Download PDF (2 MB)</a></li>Fails
<li><a href="/r25.pdf">Download</a></li>How this gets tested
The W3C publishes test rules that define what a checker looks for here.
- Link has non-empty accessible nameA tool can check this
- Link in context is descriptiveA tool can check this
- Links with identical accessible names and same context serve equivalent purposeA tool finds candidates, you decide
Other ways to satisfy this rule
22 guides on this site are filed under 2.4.4 Link Purpose (In Context). W3C lists this one as sufficient for that rule when used for identifying the purpose of a link using link text combined with programmatically determined link context, so the condition is part of the test rather than a footnote to it.
- ARIA7sufficientBuild clear link names from nearby headings
- ARIA8sufficientFix vague link text with aria-label
- C7sufficientAdd hidden text to clarify short links
- G53sufficientLet the sentence around a link explain it
- G91sufficientWrite link text that states its purpose
- G189sufficientOffer a switch to self-describing link text
This guide is our interpretation of W3C technique H77: Identifying the purpose of a link using link text combined with its enclosing list item. W3C publishes its techniques as guidance rather than as the standard, and says so on every one of them. The success criterion is what conformance is measured against, and a technique is one documented way to meet it.