swagger-api / swagger-api/swagger-editor

Screen reader does not announce label information for 'Servers' combo box in windows.

Open
#5,563 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
9.5k
Forks
2.4k
Avg merge
17h 15m
Merged PRs (30d)
18

Description

Test Environment:
OS: Windows 11 Enterprise 24H2 (OS build: 22621.2428)
Browser: Edge (Version 139.0.3405.102), Chrome Version 131.0.6778.206 (Official Build) (64-bit)
Screen Reader: NVDA (2025.1.2), JAWS (2025.2505.43), Narrator
URL: https://editor.swagger.io/

Pre-Requisite:

  1. Turn on Screen Readers:
    NVDA: Ctrl + Alt + N
    JAWS: Ctrl + Alt + J
    Narrator: Ctrl + win + Enter
  2. Verbosity:
    NVDA: Default
    JAWS: Beginner, Highest
    Narrator: Default

User Impact:
Screen reader users may find it difficult to understand the purpose of the combo box if screen reader does not announce label information for 'Servers' combo box.

Repro Steps:

  1. Open the URL: https://editor.swagger.io/ in Edge browser in windows.
  2. 'Swagger Editor' page will open.
  3. Press tab key to navigate to the 'Servers' combo box.
  4. Verify whether screen reader announces the label information for 'Servers' combo box in windows or not.

Actual Result:
Screen reader does not announce label information for 'Servers' combo box in windows.
Screen reader announces as: combo box https://petstore3.swagger.io/api/v3 collapsed

Refer Attachment:

  1. Screen reader does not announce label information for 'Servers' combo box in windows.png
  2. Screen reader does not announce label information for 'Servers' combo box in windows.mp4
Image https://github.com/user-attachments/assets/53dd3231-868e-426b-90e4-0bf54b702575

Expected Result:
Screen reader should announce label information for 'Servers' combo box in windows.
Screen reader should announce: Servers combo box https://petstore3.swagger.io/api/v3 collapsed

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 at https://editor.swagger.io/ and inspect the Servers combo box and its accessible labeling in the Swagger Editor frontend. Reproduce the issue with NVDA, JAWS, or Narrator on Windows, then verify that the control announces “Servers” before its URL and retains the expected collapsed combo-box state.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
accessibility, frontend
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.