search

pwa-builder / PWABuilder

The simplest way to create progressive web apps across platforms and devices. Start here. This repo is home to several projects in the PWABuilder family of tools.
https://docs.pwabuilder.com
Other
2.54k stars 273 forks source link

[DOCS]: Screen reader is not announcing the descriptive information for the ‘Here’ link. #4764

Open Suriya617 opened 6 days ago

Suriya617 commented 6 days ago

What happened?

Screen reader is not announcing the descriptive information for the ‘Here’ link, which is present on the page multiple times, it is announcing as ‘Link here'.

How do we reproduce the behavior?

Repro steps:

  1. Open the URL: PWABuilder - Meta Quest in edge dev browser and login with v-.

  2. Turn on the screen reader through Ctrl+ Windows+ Enter key.
  3. Navigate to the ‘Here’ link through tab key.
  4. Observe the issue.

What do you expect to happen?

Screen reader should announce the descriptive information for the ‘Here’ link. Screen reader should announce as ‘Follow the instruction on link here’.

What environment were you using?

Test Environment: OS: Windows11 OS Version: 23H2 (Build 25905.1000) Browser: Edge Dev (Version 117.0.2007.0 (Official build) dev (64-bit)) Screen reader: Narrator

Additional context

Notes:

  1. Same issue is repro for Quick Start link at https://docs.pwabuilder.com/#/
  2. Both the issue repro at every pages where they are present.
  3. Issue repro for all the links which appears multiple times at the UI.

User Impact: Screen reader users will get impacted as users will not be able to the purpose of the link and will not be able to interact or make track of the content properly.

WCAG reference link: Understanding Success Criterion 2.4.9: Link Purpose (Link Only) | WAI | W3C

Attachments:

https://github.com/pwa-builder/PWABuilder/assets/87321866/ba935ccf-43fb-4120-b7e9-544f45551562