You Are Welcome Here | UT Dallas

Research | The University of Texas at Dallas

Safety | UT Dallas

Privacy at UT Dallas

Faculty & Staff at The University of Texas at Dallas

Alumni & Friends - The University of Texas at Dallas

The University of Texas at Dallas

First time visit: View without clicking anything

Academics | UT Dallas

Two adjacent links should not point to the same destination. You almost always want to combine the 
two links.

For example, it is quite common to link an image and text together like this:

```html
<a href="news.html">
    <img src="photo.jpg" alt="" />
</a>
<a href="news.html">
    News
</a>
``` 

These adjacent links should be combined like so:

```html
<a href="news.html">
    <img src="photo.jpg" alt="" />
    News
</a>
``` 

Links to `#` are ignored, as these are nearly always placeholders for JavaScript, e.g.:

```html
<a href="#" onclick="approve()">
    OK
</a>
<a href="#" onclick="reject()">
    Cancel
</a>
```

# Justification

Many users of assistive technology are only able to experience content sequentially - that is, they must
step through each part of the page, one part at a time. Often this is a slow process, potentially 
hampered by a physical impediment.

Stepping through redundant links is time consuming; for example users of a screen reader must 
hear each link read aloud in turn. 

This also simplifies your code. 

# Methodology

1. Find all links (`<a>` tags) on the page.
2. Ignore links pointing to `#`, as these are usually placeholders for JavaScript.
3. Flag links which are (a) separated only by whitespace and (b) which point to the 
   same absolute URL.  

# Learn more

Read about [Technique H2](https://www.w3.org/TR/WCAG20-TECHS/H2) on how to combine
an adjacent image and texts links.

duplicate-adjacent-link

December 2024

November 2024

University of Texas Dallas

	Title / URL	Issues
	You Are Welcome Here \| UT Dallaswww.utdallas.edu/inclusive/	3
	Research \| The University of Texas at Dallaswww.utdallas.edu/research/	3
	Safety \| UT Dallaswww.utdallas.edu/safety/	3
	Privacy at UT Dallaswww.utdallas.edu/privacy/	3
	Directorywww.utdallas.edu/directory/	3
	Faculty & Staff at The University of Texas at Dallaswww.utdallas.edu/faculty/	3
	Alumni & Friends - The University of Texas at Dallaswww.utdallas.edu/alumni/	3
	The University of Texas at Dallaswww.utdallas.edu/	3
	First time visit: View without clicking anythingwww.utdallas.edu/	3
	Academics \| UT Dallaswww.utdallas.edu/academics/	3

Combine adjacent links with the same destination

University of Texas Dallas

Where this issue has occurred