microsoft / microsoft/BotFramework-WebChat
{Linked:Bug39039304 }[Agent Builder Skills][Preview Tab][Screen Reader]: Section headings for Justification, User impact, Business impact, and Scope are not exposed as heading levels
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 heading navigation to quickly understand page structure and move between sections. When these section titles are not exposed as headings, users must read through content sequentially to locate important information, making navigation slower and less efficient.
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
What is the public URL for the website?
https://aka.ms/agentbuilder-native-msit
How to reproduce the issue?
- Open the Agent Builder Skills application using the provided URL and sign in with valid credentials.
- Navigate to "Agents and Skills" and activate it.
- Create an agent with a valid skill and complete the setup flow.
- Navigate to the "Preview" tab and activate it.
- Enter a prompt that invokes the added skill and submit it.
- Inspect the generated response content using Accessibility Insights, browser developer tools, or screen reader heading navigation commands.
- Observe the sections Justification, User impact, Business impact, and Scope.
What do you expect?
The element should expose Justification, User impact, Business impact, and Scope as programmatically determinable headings using appropriate semantic heading markup or equivalent ARIA heading roles with valid heading levels so that assistive technologies can accurately convey the document structure.
What actually happened?
The sections Justification, User impact, Business impact, and Scope are visually presented as section headers; however, they are not programmatically exposed as heading elements. As a result, assistive technologies do not identify these section titles as headings, and users cannot navigate directly to them using heading navigation commands.
Do you have any screenshots or recordings to repro the issue?
No response
Did you find any DOM elements that might have caused the issue?
No response
MAS reference
WCAG reference
No response
WAI-ARIA reference
No response
Adaptive Card JSON
Additional context
https://github.com/user-attachments/assets/35c8f11e-3441-40e4-a180-b138e6bcffd5
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 by reproducing the issue in the Agent Builder Skills Preview tab using the provided URL, then inspect the Justification, User impact, Business impact, and Scope elements with Accessibility Insights or browser developer tools. Done means those sections are exposed as semantic headings with valid heading levels and are reachable through screen reader heading navigation.
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
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100