Articles | The Donkey Sanctuary

All about donkeys | The Donkey Sanctuary

Online Shop | The Donkey Sanctuary Shop | The Donkey Sanctuary Shop

Contact us | The Donkey Sanctuary

Donkey Care | The Donkey Sanctuary

For professionals | The Donkey Sanctuary

Why donkeys matter | The Donkey Sanctuary

Shopping basket | The Donkey Sanctuary

What we do | The Donkey Sanctuary

Support us | The Donkey Sanctuary

When specifying accessible names via `aria-labelledby`, ensure that the 
label elements exist.

## Explanation

Accessible names are required for many parts of a page, including form controls.
One way to accomplish this is to use `aria-labelledby` to specify the ID or IDs of 
other elements which contain a label. For example:

```html
<h2 id="dialog-labell">Important message!</h2>
<dialog aria-labelledby="dialog-label">
```

In this example, the `aria-labelledby` for the `<dialog>` points to an ID of `dialog-label`,
which doesn't exist. The heading it refers to instead has an ID of `dialog-labell`, presumably 
a typo.

## Why this matters

It isn't usually clear when an accessible name is broken, even during user testing.

This check helps to identify where an element clearly intended to have a label, but
that label is missing.

When a label is broken, it may be impossible for a user of assistive technologies
to understand what that element does.

missing-aria-labelled-by

June 2025

May 2025

The Donkey Sanctuary

	Title / URL	Issues
	Articles \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/articles	1
	All about donkeys \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/all-about-donkeys	1
	Online Shop \| The Donkey Sanctuary Shop \| The Donkey Sanctuary Shopwww.thedonkeysanctuary.org.uk/shop/	1
	Contact us \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/contact	1
	Donkey Care \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/donkey-care	1
	For professionals \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/for-professionals	1
	Why donkeys matter \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/why-donkeys-matter	1
	Shopping basket \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/basket	1
	What we do \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/what-we-do	1
	Support us \| The Donkey Sanctuarywww.thedonkeysanctuary.org.uk/support-us	1

Fix missing ARIA label IDs

The Donkey Sanctuary

Where this issue has occurred