# VGAR Content Requirements

## Content

### Requirements

- **Heading Structure (CON-001)**
- **Semantic Markup (CON-002)**
- **Logical Order (CON-003)**
- **Lists and Paragraphs (CON-004)**
- **Logical Link Text (CON-005)**
- **Senseless Instructions (CON-006)**
- **Lang for Foreign Words (CON-007)**
- **Tabular Data (CON-008)**
- **Context Cues Agree (CON-009)**

## Logical Link Text (CON-WEB-005)

### Write link text that makes sense to all users

Link text must describe the destination or purpose of every link in a way that makes the destination or purpose clear to all users when taken out of context. Some of the link text may be hidden via CSS provided the text left visible makes sense when taken out of context of the enclosing sentence, table header(s) or preceding heading.

For instance, link text like “click here” does not communicate link purpose or destination unless you can see the surrounding content.

### Requirements

#### Link Text In and Out of Context (CON-WEB-005-01)

Link text MUST describe the destination or purpose of every link in a way that makes the destination or purpose clear to all users when taken out of context (i.e., in a list of links for the page). Some of the link text may be hidden via CSS provided the text left visible makes sense when taken in context of the enclosing sentence, table header(s) or preceding heading.

## Test Procedures

#### Screen reader > Links (CON-WEB-005-01-T)

Bring up the list of links with each supported screen reader if available and confirm that all link text describes the destination or purpose of every link in a way that makes the destination or purpose clear to all users when taken out of context (i.e., in a list of links for the page). Some of the link text may be hidden via CSS provided the text left visible makes sense when taken in context of the enclosing sentence, table header(s) or preceding heading.

## Related Content

#### WCAG Success Criteria

- **2.4.4 Link Purpose (In Context)**

#### W3C Techniques

- **G91: Providing link text that describes the purpose of a link**  
- **H30: Providing link text that describes the purpose of a link for anchor elements**  
- **H24: Providing text alternatives for the area elements of image maps**  
- **G53: Identifying the purpose of a link using link text combined with the text of the enclosing sentence**  
- **H33: Supplementing link text with the title attribute**  
- **C7: Using CSS to hide a portion of the link text**  
- **ARIA7: Using aria-labelledby for link purpose**  
- **ARIA8: Using aria-label for link purpose**  
- **H77: Identifying the purpose of a link using link text combined with its enclosing list item**  
- **H78: Identifying the purpose of a link using link text combined with its enclosing paragraph**  
- **H79: Identifying the purpose of a link in a data table using the link text combined with its enclosing table cell and associated table header cells**  
- **H2: Combining adjacent image and text links for the same resource**  
- **H80: Identifying the purpose of a link using link text combined with the preceding heading element**

#### Common Failures

- **F63: Failure of Success Criterion 2.4.4 due to providing link context only in content that is not related to the link**  
- **F89: Failure of Success Criteria 2.4.4, 2.4.9 and 4.1.2 due to not providing an accessible name for an image which is the only content in a link**