algolia / algolia/docsearch

Screen reader fails announcing about the group name associated with suggestions available while navigating along the suggestions.

Open
#2,041 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
4.4k
Forks
439
Avg merge
14h 32m
Merged PRs (30d)
19

Description

## Description
Screen reader fails announcing about the group name associated with suggestions available while navigating along the suggestions.User with visual impairment who rely on screen reader will face difficulties if associated group name is not announced by screen reader.

## Steps to reproduce

1. Open https://www.fast.design/ URL.
2. Navigate to link ‘Documentation’ and invoke it.
3. Navigate to button 'Search' and invoke it.
4. Search for any keyword and navigate to suggestions available.
5. Listen to screen reader announcement.

**Live reproduction:**

[Associated label is not announced .webm](https://github.com/algolia/docsearch/assets/93735775/79589538-5823-4c1b-a4b4-7f933c05e169)

https://github.com/algolia/docsearch/assets/93735775/5545de2b-09ea-4a42-afbb-43fa8bb56463

## Expected behavior

Screen reader should announce about the group associated with suggestions available while navigating along the suggestions.

i.e., When user enter the suggestions group, screen reader should announce as 'and along .

## Environment

OS Ver: 25324.1011
Edge Ver: 112.0.1722.23 (Official build) dev (64-bit)
URL: [FAST](https://www.fast.design/)

Contributor guide

Open the contributing guide

Research direction

Start by reproducing the issue on the FAST documentation site: open Search, enter a keyword, and navigate the suggestions with a screen reader. Trace the search suggestion accessibility implementation and verify that entering a group announces its group name, suggestion name, and position as described.

Written by the indexing model from the issue text.

Assessment

Tech stack
react, typescript
Domain
accessibility, frontend, search
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.