Skip to content

Add group role and aria-labeledby attribute to groups.#6087

Open
tlfdev wants to merge 1 commit intoJedWatson:masterfrom
tlfdev:A11Y-groups
Open

Add group role and aria-labeledby attribute to groups.#6087
tlfdev wants to merge 1 commit intoJedWatson:masterfrom
tlfdev:A11Y-groups

Conversation

@tlfdev
Copy link

@tlfdev tlfdev commented Jan 21, 2026

I am a native screen reader user. The groups example on the start page do not present the groups to the screen reader. Because groups are essentially div elements, they do not have the proper role, nor do they have the proper label.
In this fix, I assigned an ID if no ID existed to the group heading label. Then I used that ID to populate the aria-labeledby attribute. The secondary fix was to add a role of group to the div, so that screen readers and the accessibility tree know that the div is a group.
Now when navigating through this combobox, I hear the group heading as I arrow to an item in that group with the number of items in the group. This is proper and expected behavior.

@changeset-bot
Copy link

changeset-bot bot commented Jan 21, 2026

⚠️ No Changeset found

Latest commit: d693c29

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@codesandbox-ci
Copy link

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant