# Identifying the purpose of a link using link text combined with its enclosing list item

ID: H77

Technology: html

Type: Technique

## When to Use

All technologies that contain links.

## Description

The objective of this technique is to identify the purpose of a link from the link and its list item context. The list item enclosing the link provides context for an otherwise unclear link when the list item is the nearest enclosing block-level ancestor element. The description lets a user distinguish this link from links in the Web page that lead to other destinations and helps the user determine whether to follow the link. Note that simply providing the URI of the destination is generally not sufficiently descriptive.

These descriptions will be most useful to the user if the additional information needed to understand the link precedes the link. If the additional information follows the link, there can be confusion and difficulty for screen reader users who are reading through the page in order (top to bottom).

## Examples

    <ul>
      <li>
        Check out the video report for last year's
        <a href="festival.html">National Folk Festival</a>.
      </li>
      <li>
        <a href="listen.html">Listen to the instruments</a>
      </li>
      <li>
        Guitar Man: George Golden talks about
        <a href="mkguitars.html">making guitars</a>.
      </li>
    </ul>

### A list of video games for download

    <ul>
      <li>
        <a href="zelda-tears.html">Legend Of Zelda: Tears Of The Kingdom</a>
        <a href="zelda-tears-images.html">See Images</a>
        <a download href="zelda-tears-demo.mp4">Download Demo</a>
      </li>
      <li>
        <a href="metroid-prime.html">Metroid Prime</a>
        <a href="metroid-prime-images.html">See Images</a>
        <a download href="metroid-prime-demo.mp4">Download Demo</a>
      </li>
      <li>
        <a href="grand-theft-auto.html">Grand Theft Auto</a>
        <a href="grand-theft-auto-images.html">See Images</a>
        <a download href="grand-theft-auto.mp4">Download Demo</a>
      </li>
    </ul>

## Tests

### Procedure

For each link in the content that uses this technique:

1. Check that the link is part of a list item.
2. Check that text of the link combined with the text of its enclosing list item describes the purpose of the link.

### Expected Results

- The above checks are true.

## Related Techniques

- G53
- G91
- H33
- H78
- H79
- H80
- H81
- C7

## Resources