Guidance on Preparation for Teaching and Learning

Home - National Council for Curriculum and Assessment

Outdoor Learning | NCCA

Baile | NCCA

For Parents | NCCA

Primary Developments | NCCA

Early Years of Primary | NCCA

Primary | NCCA

Junior Cycle | NCCA

Latest News | NCCA

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

October 2024

September 2024

National Council for Curriculum and Assessment

Title / URL	Issues
Guidance on Preparation for Teaching and Learningncca.ie/en/primary/preparation/	3
Home - National Council for Curriculum and Assessmentncca.ie/en/	3
Outdoor Learning \| NCCAncca.ie/en/primary/outdoor-learning/	3
Baile \| NCCAncca.ie/ga/	3
For Parents \| NCCAncca.ie/en/early-childhood/for-parents/	3
Primary Developments \| NCCAncca.ie/en/primary/primary-developments/	3
Early Years of Primary \| NCCAncca.ie/en/primary/early-years-of-primary/	3
Primary \| NCCAncca.ie/en/primary/	3
Junior Cycle \| NCCAncca.ie/en/junior-cycle/	3
Latest News \| NCCAncca.ie/en/updates-and-events/latest-news/	3

Fix missing ARIA label IDs

National Council for Curriculum and Assessment

Where this issue has occurred