Blog resources and insights from RRD | RRD

A Resource Library Featuring Our Latest Insights | RRD

Guide resources and insights from RRD | RRD

RRD | Marketing, packaging, print & supply chain expertise

First time visit: View without clicking anything

Retail Industry Services and Solutions | RRD

Grocery and Convenience Store Industry Services | RRD

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

November 2024

October 2024

R.R. Donnelley & Sons

Title / URL	Issues
Blog resources and insights from RRD \| RRDwww.rrd.com/resources/blog	100
A Resource Library Featuring Our Latest Insights \| RRDwww.rrd.com/resources	16
Guide resources and insights from RRD \| RRDwww.rrd.com/resources/guide	14
RRD \| Marketing, packaging, print & supply chain expertisewww.rrd.com/	8
First time visit: View without clicking anythingwww.rrd.com/	8
Retail Industry Services and Solutions \| RRDwww.rrd.com/industries/retail	4
Grocery and Convenience Store Industry Services \| RRDwww.rrd.com/industries/grocery	4

Combine adjacent links with the same destination

R.R. Donnelley & Sons

Where this issue has occurred