microsoft / microsoft/BotFramework-WebChat

[white Label - Audiocard]: Narrator focus is moving to hidden after No buttons,… text while navigating using arrow keys.

Open
#5,714 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A11ySev3 A11yWCAG Accessibility area-accessibility Bot Services BotFrameworkWebChat_Web bug customer-reported HCL-BIC
Dominant language
HTML
Stars
1.8k
Forks
1.6k
Avg merge
22h 58m
Merged PRs (30d)
2

Description

Is it an issue related to Adaptive Cards?

No.

What is the PWD impact?

Screen reader users hear misleading information about the element being part of a list even when it is not. This creates confusion, disrupts navigation, and makes it harder for users to understand the actual structure and purpose of the audio file element.

What browsers and screen readers do this issue affect?

Others, Windows: Edge with Windows Narrator

Are there any code-based customization done to Web Chat?

No, I am using Web Chat without any customizations except "styleOptions".

What version of Web Chat are you using?

Latest production

Which area does this issue affect?

Others or unrelated

What is the public URL for the website?

No response

How to reproduce the issue?

Pre-Requisite:
Turn on Narrator

Repro Steps

  1. Open URL: https://compulim.github.io/webchat-loader/ and sign in using valid credentials.
  2. Navigate to web chat page and select 4.18.1-main.20240927.ea7a875 (30/9/2024) version and then select mockBot link under present label and then select open web chat in new window link at bottom.
    3.Navigate to white label experience chat page and type audiocard word in type your message text box.
  3. Response will appear.
  4. Navigate to the Audio file using arrow keys.
  5. Observe an issue that Narrator announcing unnecessary list information when focus lands on whole audio file while navigating using arrow keys.
What do you expect?

The element should expose only the appropriate programmatic role and semantics for an audio file. Narrator should announce only relevant information about the audio file and should not include list‑related semantics unless the element is explicitly a list or listitem.

What actually happened?

Narrator focus is moving to hidden after No buttons,… text while navigating using arrow keys.

Do you have any screenshots or recordings to repro the issue?

https://github.com/user-attachments/assets/1ad84d9a-ae28-4c4f-8914-7a9150ac022a

Did you find any DOM elements that might have caused the issue?

No response

MAS reference

No response

WCAG reference

No response

WAI-ARIA reference

No response

Adaptive Card JSON

Additional context

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the issue at the webchat-loader URL using Web Chat version 4.18.1-main.20240927.ea7a875, Windows Narrator, Edge, and the audiocard response. Inspect the audio file's DOM and accessibility tree while navigating with arrow keys; done means focus no longer lands on hidden text and Narrator reports only the audio file's appropriate semantics, without list information.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
accessibility, frontend
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.