microsoft / microsoft/WPF-Samples

"Method Signature" edit field incorrect role is given as document: A11y_WPF_Change signature_ScreenReader

Open
#807 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C#
Stars
5.7k
Forks
3.3k
Avg merge
12d 8h
Merged PRs (30d)
2

Description

GitHub Tags:
#A11ySev2; #A11yTCS; #WCAG4.1.2; #Win32; #DesktopApp; #Win11; #WPF; #BM_WPFRuntime_Win32_JUNE2025; #NameRoleValue; #a11ydb-widget-wrong-role;

Issue Subcategory:

Interactive element or widget has incorrect role

User Experience:

Assistive technology announces the wrong control type, confusing users about how to operate the element or what it does.

Repro Steps:

Turn on NVDA > Launch Visual Studio 2026> Open any project > Open any file > Provide the below code
"// Invoke change signature in Func2 to trigger change signature
int Func2(int a, int b, int c)"

Select Complete line "Func2" and Press "Ctrl + ." > Change signature list item > "Method Signature" edit field > Observe the issue: "Method Signature" edit field incorrect role is given as document

Actual:

When focus moves to the "Method Signature" edit field, screen readers announce it as a "document" instead of an edit field.

Expected:

When focus moves to the "Method Signature" field, screen readers should announce the correct role as "edit" (or appropriate text input role) so users can understand that the control accepts text input.

How to Fix

Assign the role that matches the control's actual behavior, or use the native element that conveys it (<button>, <a href>, <select>). Verify the role against the intended ARIA pattern.

Environment Details:

Application Name: WPF
Visual Studio 2026
18.9.0 Canary [11916.14.main]
Edition Windows 11 Enterprise Insider Preview
OS Version 25H2
OS build 26544.1000

Note

"Please do not close this bug. This bug should only be closed by TCS, C+AI Accessibility tester after bug verification."
"Check out Accessibility Insights! - Identify accessibility bugs before check-in and make bug fixing faster and easier."
"Contact CAI Accessibility Support Channel for Accessibility queries on design, development, test, usability or any processes"

Attachment:
Image Image

WpfApp9.zip

Contributor guide

No contributing guide indexed for this repository

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 with NVDA in Visual Studio 2026 by opening a project, invoking Change Signature with Ctrl + ., and focusing the “Method Signature” field. The payload names no source file or test, so first identify which component owns this control; done means the field is exposed as an edit or appropriate text-input role rather than a document.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
accessibility, desktop
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.