Search | Alliance Homes

Benefits and welfare | Alliance Homes

Find a home | Alliance Homes

Swapping your home | Alliance Homes

Leaseholder information | Alliance Homes

Connect, our customer portal | Alliance Homes

404 | Alliance Homes

Which repairs should I do? | Alliance Homes

Rent a home | Alliance Homes

Shared Ownership | Alliance Homes

Links must be defined in a specific way to be accessed by screen readers, which are used by 
blind and the partially-sighted.

To work with accessibility technologies, links must contain both machine-readable text, and 
a `href` attribute. If a link is not actually
pointing to a page or part of a page, it should be replaced with another semantic element, such
as a `button`, or the `<a>` tag should have a role of `button`. 

For example:

```html
<a href="/about">About us</a>
```

If the link contains _nothing but an image_, that image should specify alternative text, e.g.

```html
<a href="/apple">
    <img src="apple.png" alt="Apple">
</a>
```

Before HTML5, an anchor was often used to create a target to link to, e.g.

```html
<a name="example"></a>
```

This is not supported in HTML5, and the use of anchors for targets is discouraged. Use an `id`
attribute on a non-anchor tag instead, e.g.

```html
<div id="example"> ... </div>
```

Empty links (e.g. `<a></a>`) are often incorrectly used for buttons or controls in a
JavaScript application. In these cases, you should usually define the link as having a more appropriate
role, e.g. as a button. To do this, use the `role` attribute (e.g `<a role="button">`), or replace 
the `<a>` tag with a more appropriate tag, such as `<button>`.

For more details, see [Technique H91](https://www.w3.org/TR/2016/NOTE-WCAG20-TECHS-20161007/H91)
and learn about [ARIA roles](https://www.sitepoint.com/how-to-use-aria-effectively-with-html5/).

bad-anchor

May 2025

April 2025

NSAH (Alliance Homes) Limited

Title / URL	Issues
Search \| Alliance Homeswww.alliancehomes.org.uk/search/	3
Benefits and welfare \| Alliance Homeswww.alliancehomes.org.uk/your-home/benefits-and-welfare/	3
Find a home \| Alliance Homeswww.alliancehomes.org.uk/find-a-home/	3
Swapping your home \| Alliance Homeswww.alliancehomes.org.uk/find-a-home/swapping-your-home/	3
Leaseholder information \| Alliance Homeswww.alliancehomes.org.uk/your-home/leaseholder-information/	3
Connect, our customer portal \| Alliance Homeswww.alliancehomes.org.uk/your-home/connect-our-customer-portal/	3
404 \| Alliance Homeswww.alliancehomes.org.uk/invented-url-for-404-page/	3
Which repairs should I do? \| Alliance Homeswww.alliancehomes.org.uk/repairs/which-repairs-should-i-do/	3
Rent a home \| Alliance Homeswww.alliancehomes.org.uk/find-a-home/rent-a-home/	3
Shared Ownership \| Alliance Homeswww.alliancehomes.org.uk/find-a-home/shared-ownership/	3

Ensure links can be used by screen readers

NSAH (Alliance Homes) Limited

Where this issue has occurred