Search - IBM Training - Global

IBM Products

IBM - United States

IBM Impact: IBM's ESG Framework | IBM

First time visit: View without clicking anything

Analyst Reports Discovery Page | IBM

IBM Diversity and Inclusion | Be Equal

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

International Business Machines

Title / URL	Issues
Search - IBM Training - Globalwww.ibm.com/training/search?q=course&lnk=fpo	4
IBM Productswww.ibm.com/products	3
IBM Productswww.ibm.com/products?lnk=fps	3
IBM - United Stateswww.ibm.com/us-en	3
IBM Impact: IBM's ESG Framework \| IBMwww.ibm.com/impact	3
First time visit: View without clicking anythingwww.ibm.com/us-en	3
Analyst Reports Discovery Page \| IBMwww.ibm.com/reports/analyst/?lnk=fab	2
IBM Diversity and Inclusion \| Be Equalwww.ibm.com/impact/be-equal/?lnk=fab	1

Fix missing ARIA label IDs

International Business Machines

Where this issue has occurred