microsoft / microsoft/BotFramework-WebChat
[White Label -Audiocard]: Narrator announcing twice information as heading level for BotFramework Test text.
Nobody has claimed this yet.
- 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 rely on clear and non‑redundant announcements to understand page structure. Repeated heading information causes confusion, increases cognitive load, and may lead users to believe multiple headings exist when there is only one.
What browsers and screen readers do this issue affect?
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?
ARIA roles, 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
- Open URL: https://compulim.github.io/webchat-loader/ and sign in using valid credentials.
- 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. - Response will appear.
- Navigate to BotFramework Test text.
- Observe an issue that Narrator announcing twice information as heading level for BotFramework Test text.
What do you expect?
The element should expose a single, accurate heading role so that Narrator announces the heading level only once, without duplicate or redundant information.
What actually happened?
Narrator announcing twice information as heading level for BotFramework Test text.
Do you have any screenshots or recordings to repro the issue?
https://github.com/user-attachments/assets/f82e2518-9eed-4265-91a7-446a9e36892a
Did you find any DOM elements that might have caused the issue?
No response
MAS reference
No response
WCAG reference
https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships
WAI-ARIA reference
No response
Adaptive Card JSON
Additional context
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start at the provided Web Chat Loader reproduction URL, using version 4.18.1-main.20240927.ea7a875 and the white label Audiocard flow. Inspect the DOM and accessibility information for the “BotFramework Test” text, then verify with Windows Narrator that the heading level is announced only once.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- accessibility, frontend
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100