Job vacancies | Working for Samaritans

How Samaritans can help in the workplace

Donate to Samaritans | Donations | Samaritans Charity Donations

Contact Us | Samaritans

First time visit: View without clicking anything

Other ways to support us | Samaritans

Samaritans | Every life lost to suicide is a tragedy | Here to listen

In prisons | How we can help | Samaritans

In the military and Armed Forces Community | How we can help

Campaigns

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

February 2025

January 2025

Samaritans

Title / URL	Issues
Job vacancies \| Working for Samaritanswww.samaritans.org/ireland/about-samaritans/jobs/	3
How Samaritans can help in the workplacewww.samaritans.org/ireland/how-we-can-help/workplace/	3
Donate to Samaritans \| Donations \| Samaritans Charity Donationswww.samaritans.org/ireland/donate-now/?currency=GBP	3
Contact Us \| Samaritanswww.samaritans.org/ireland/how-we-can-help/contact-samaritan/	3
First time visit: View without clicking anythingwww.samaritans.org/?currency=EUR&nation=ireland	3
Other ways to support us \| Samaritanswww.samaritans.org/ireland/support-us/other-ways-support-us/	3
Samaritans \| Every life lost to suicide is a tragedy \| Here to listenwww.samaritans.org/?currency=EUR&nation=ireland	3
In prisons \| How we can help \| Samaritanswww.samaritans.org/ireland/how-we-can-help/prisons/	3
In the military and Armed Forces Community \| How we can helpwww.samaritans.org/ireland/how-we-can-help/military/	3
Campaignswww.samaritans.org/ireland/support-us/campaign/	3

Fix missing ARIA label IDs

Samaritans

Where this issue has occurred