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

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

Nobody has claimed this yet.

area-accessibility Bot Services bug customer-reported
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?
  1. Open the Agent Builder Skills application using the provided URL and sign in with valid credentials.
  2. Navigate to "Agents and Skills" and activate it.
  3. Create an agent with a valid skill and complete the setup flow.
  4. Navigate to the "Preview" tab and activate it.
  5. Enter a prompt that invokes the added skill and submit it.
  6. Inspect the generated response content using Accessibility Insights, browser developer tools, or screen reader heading navigation commands.
  7. 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

https://aka.ms/MAS1.3.1

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

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

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.