microsoft / microsoft/BotFramework-WebChat
Heading is not defined for ‘Adaptive Card design session’ 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?
Yes, this is related to Adaptive Card. However, it does not repro on Adaptive Cards Designer.
What is the PWD impact?
When the “Adaptive Card design session” text is not defined as a heading, screen reader users and those relying on structured navigation cannot understand the hierarchy of the page. They may miss that “Breakfast” is a section title, making it harder to skim or jump directly to that content.
What browsers and screen readers do this issue affect?
No response
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?
Repro Steps:
- Open URL: Web Chat in edge browser.
- Ask query 'Card Calendar'.
- Navigate to message.
- Observe the issue that Heading is not defined for ‘Adaptive Card design session’ text.
What do you expect?
Heading should be defined for ‘Adaptive Card design session’ text.
What actually happened?
Heading is not defined for ‘Adaptive Card design session’ text.
Do you have any screenshots or recordings to repro the issue?
https://github.com/user-attachments/assets/d18dc792-8d30-4ca0-851e-340cfc7675ad
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 with the Web Chat message produced by the “Card Calendar” query and inspect the rendered structure around “Adaptive Card design session” and “Breakfast.” Reproduce the screen-reader navigation issue in Edge, then verify that the affected text has appropriate heading semantics without disrupting the card hierarchy.
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
- 38/100