Link text replaced by aria-labelledby attribute Screen reader compatibility

ARIA HTML WCAG
Nov 26, 2024

Expected Result: works in a screen reader

Actual Result: causes problems in 9 screen reader / browser combinations

A much more reliable alternative is changing the text inside in the link element start and end tags.

Tests if the user hears the ARIA label as specified by HTML Accessibility API Mappings

WCAG Technique: ARIA7

Code used for this test:


		<a href='4567.html' aria-labelledby='a-aria-labelledby-clickhere'>Click Here</a>
		<span id='a-aria-labelledby-clickhere'>this is an aria labelled by</span>
	

Reliability Trend

This graph shows reliability over time for this code in NVDA, JAWS and Voiceover. Other screen readers don't have enough historical data yet to plot trends.

100%80%60%40%20%0%201491%201591%201691%201791%201893%201993%2020100%2021100%2022100%2023100%2024100%

Change History

Last updated: November 26, 2024

  • Good NVDA with Chrome Stable - OK from NVDA 2018.4 to NVDA 2024.4
  • Bad NVDA with IE Causes problems in NVDA 2019.2
  • Better NVDA with FF Better - caused problems in NVDA 2014.1, but now OK in NVDA 2024.4
  • Good JAWS with Chrome Stable - OK from JAWS 2018.1811.2 to JAWS 2024.2409.2
  • Better JAWS with IE Better - caused problems in JAWS 13.0.852, but now OK in JAWS 2019.1912.1
  • Good JAWS with FF Stable - OK from JAWS 13.0.852 to JAWS 2024.2409.2
  • Good VoiceOver macOS Stable - OK from VoiceOver macOS 10.9 to VoiceOver macOS 14.6
  • Good VoiceOver iOS Stable - OK from VoiceOver iOS 7.1 to VoiceOver iOS 17.7
  • Good WindowEyes with IE Stable - OK from WindowEyes 8.4 to WindowEyes 9.2
  • Good Dolphin with IE OK in Dolphin SR 15.05
  • Bad SaToGo with IE Causes problems in SaToGo 3.4.96.0
Screen readerBrowserModeNotesWhat the user hears
OK NVDA 2024.4Chrome 131 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2024.4Chrome 131 Tabbing This is an aria labelled by, link
OK NVDA 2024.4FF 128 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2024.4FF 128 Tabbing This is an aria labelled by, link
OK NVDA 2024.4Edge 131 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2024.4Edge 131 Tabbing This is an aria labelled by, link
OK NVDA 2023.3Chrome 120 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2023.3Chrome 120 Tabbing This is an aria labelled by, link
OK NVDA 2023.3FF 115 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2023.3FF 115 Tabbing This is an aria labelled by, link
OK NVDA 2023.3Edge 120 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2023.3Edge 120 Tabbing This is an aria labelled by, link
OK NVDA 2022.2Chrome 105 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2022.2Chrome 105 Tabbing This is an aria labelled by, link
OK NVDA 2022.2FF 102 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2022.2FF 102 Tabbing This is an aria labelled by, link
OK NVDA 2022.2Edge 105 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2022.2Edge 105 Tabbing This is an aria labelled by, link
OK NVDA 2021.2Chrome 94 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2021.2Chrome 94 Tabbing This is an aria labelled by, link
OK NVDA 2021.2FF 91 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2021.2FF 91 Tabbing This is an aria labelled by, link
OK NVDA 2021.2Edge 94 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2021.2Edge 94 Tabbing This is an aria labelled by, link
OK NVDA 2020.2Chrome 86 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2020.2Chrome 86 Tabbing This is an aria labelled by, link
OK NVDA 2020.2FF 78 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2020.2FF 78 Tabbing This is an aria labelled by, link
OK NVDA 2020.2Edge 92 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2020.2Edge 92 Tabbing This is an aria labelled by, link
OK NVDA 2019.2Chrome 79 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2019.2Chrome 79 Tabbing This is an aria labelled by, link
OK NVDA 2019.2FF 68 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2019.2FF 68 Tabbing This is an aria labelled by, link
OK NVDA 2019.2IE11 Reading Link click here, this is an aria labelled by
Fail NVDA 2019.2IE11 Tabbing aria-labelledby ignored Click here, link
OK NVDA 2018.4Chrome 73 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2018.4Chrome 73 Tabbing This is an aria labelled by, link
OK NVDA 2018.4FF 60 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2018.4FF 60 Tabbing This is an aria labelled by, link
OK NVDA 2018.4IE11 Reading Link click here, this is an aria labelled by
Fail NVDA 2018.4IE11 Tabbing aria-labelledby ignored Click here, link
OK NVDA 2017.3FF 60 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2017.3FF 60 Tabbing This is an aria labelled by, link
OK NVDA 2017.3IE11 Reading Link click here, this is an aria labelled by
Fail NVDA 2017.3IE11 Tabbing aria-labelledby ignored Click here, link
OK NVDA 2016.2FF 48 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2016.2FF 48 Tabbing This is an aria labelled by, link
OK NVDA 2016.2IE11 Reading Link click here, this is an aria labelled by
Fail NVDA 2016.2IE11 Tabbing aria-labelledby ignored Click here, link
OK NVDA 2015.2FF 40 Reading Link, this is an aria labelled by, this is an aria labelled by
OK NVDA 2015.2FF 40 Tabbing This is an aria labelled by, link
OK NVDA 2015.2IE11 Reading Link click here, this is an aria labelled by
Fail NVDA 2015.2IE11 Tabbing aria-labelledby ignored Click here, link
OK NVDA 2014.1FF 28 Reading link click here, this is an aria labelled by
Fail NVDA 2014.1FF 28 Tabbing aria-labelledby ignored Click here, link
OK NVDA 2014.1IE11 Reading link click here, this is an aria labelled by
OK NVDA 2014.1IE11 Tabbing Click here, this is an aria labelled by, link
OK NVDA 2012.1FF 28 Reading link click here
Fail NVDA 2012.1FF 28 Tabbing aria-labelledby ignored click here link
OK NVDA 2012.3IE11 Reading link click here, this is an aria labelled by
OK NVDA 2012.3IE11 Tabbing click here, this is an aria labelled by link
OK JAWS 2024.2409.2Chrome 131 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2024.2409.2Chrome 131 Tabbing This is an aria labelled by, link
OK JAWS 2024.2409.2FF 128 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2024.2409.2FF 128 Tabbing This is an aria labelled by, link
OK JAWS 2024.2409.2Edge 131 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2024.2409.2Edge 131 Tabbing This is an aria labelled by, link.
OK JAWS 2023.2311.34Chrome 120 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2023.2311.34Chrome 120 Tabbing This is an aria labelled by, link
OK JAWS 2023.2311.34FF 115 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2023.2311.34FF 115 Tabbing This is an aria labelled by, link
OK JAWS 2023.2311.34Edge 120 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2023.2311.34Edge 120 Tabbing This is an aria labelled by, link.
OK JAWS 2022.2207.25Chrome 105 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2022.2207.25Chrome 105 Tabbing This is an aria labelled by, link
OK JAWS 2022.2207.25FF 102 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2022.2207.25FF 102 Tabbing This is an aria labelled by, link
OK JAWS 2022.2207.25Edge 105 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2022.2207.25Edge 105 Tabbing This is an aria labelled by, link.
OK JAWS 2021.2107.12Chrome 94 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2021.2107.12Chrome 94 Tabbing This is an aria labelled by, link
OK JAWS 2021.2107.12FF 91 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2021.2107.12FF 91 Tabbing This is an aria labelled by, link
OK JAWS 2021.2107.12Edge 94 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2021.2107.12Edge 94 Tabbing This is an aria labelled by, link.
OK JAWS 2020.2008.24Chrome 86 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2020.2008.24Chrome 86 Tabbing This is an aria labelled by, link
OK JAWS 2020.2008.24FF 78 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2020.2008.24FF 78 Tabbing This is an aria labelled by, link
OK JAWS 2020.2008.24Edge 92 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2020.2008.24Edge 92 Tabbing This is an aria labelled by, link.
OK JAWS 2019.1912.1Chrome 79 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2019.1912.1Chrome 79 Tabbing This is an aria labelled by, link
OK JAWS 2019.1912.1FF 68 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2019.1912.1FF 68 Tabbing This is an aria labelled by, link
OK JAWS 2019.1912.1IE11 Reading Link, click here. This is an aria labelled by.
OK JAWS 2019.1912.1IE11 Tabbing still displayed as 'Click Here' in List Links window. This is an aria labelled by, link.
OK JAWS 2018.1811.2Chrome 73 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 2018.1811.2Chrome 73 Tabbing Tab, this is an aria labelled by, link
OK JAWS 2018.1811.2FF 60 Reading reads out what's on screen - reasonable behavior Link, click here. This is an aria labelled by.
OK JAWS 2018.1811.2FF 60 Tabbing Tab, this is an aria labelled by, link
OK JAWS 2018.1811.2IE11 Reading Link, click here. This is an aria labelled by.
OK JAWS 2018.1811.2IE11 Tabbing still displayed as 'Click Here' in List Links window. Tab, this is an aria labelled by, link.
OK JAWS 18.0.5038FF 52 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 18.0.5038FF 52 Tabbing Tab, this is an aria labelled by, link
OK JAWS 18.0.5038IE11 Reading Link, click here. This is an aria labelled by.
OK JAWS 18.0.5038IE11 Tabbing still displayed as 'Click Here' in List Links window. Tab, this is an aria labelled by, link.
OK JAWS 17.0.2619FF 48 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 17.0.2619FF 48 Tabbing This is an aria labelled by, link
OK JAWS 17.0.2619IE11 Reading Link, click here. This is an aria labelled by.
OK JAWS 17.0.2619IE11 Tabbing still displayed as 'Click Here' in List Links window. This is an aria labelled by, link.
OK JAWS 16.0.4350FF 40 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 16.0.4350FF 40 Tabbing This is an aria labelled by, link
OK JAWS 16.0.4350IE11 Reading Link, click here. This is an aria labelled by.
OK JAWS 16.0.4350IE11 Tabbing This is an aria labelled by, link.
OK JAWS 15.0.9023FF 29 Reading Link, this is an aria labelled by. This is an aria labelled by.
OK JAWS 15.0.9023FF 29 Tabbing This is an aria labelled by, link
OK JAWS 15.0.9023IE11 Reading Link, click here. This is an aria labelled by.
OK JAWS 15.0.9023IE11 Tabbing This is an aria labelled by, link.
OK JAWS 14.0.9002FF 29 Reading link, this is an aria labelled by, this is an aria labelled by
OK JAWS 14.0.9002FF 29 Tabbing This is an aria labelled by link
OK JAWS 14.0.9002IE11 Reading link click here, this is an aria labelled by
OK JAWS 14.0.9002IE11 Tabbing This is an aria labelled by link
OK JAWS 13.0.852FF 28 Reading link click here
OK JAWS 13.0.852FF 28 Tabbing This is an aria labelled by link
OK JAWS 13.0.852IE11 Reading link click here
Fail JAWS 13.0.852IE11 Tabbing aria-labelledby ignored click here link
OK WindowEyes 9.2IE11 Reading Link, this is an aria labelled by
OK WindowEyes 9.2IE11 Tabbing Link, this is an aria labelled by
OK WindowEyes 8.4IE11 Reading reads out what's on screen - reasonable behavior Link click here
OK WindowEyes 8.4IE11 Tabbing Link, this is an aria labelled by
OK VoiceOver macOS 14.6Safari 17.6 Reading Link, this is an aria labelled by. This is an aria labelled by
OK VoiceOver macOS 14.6Safari 17.6 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 13.6Safari 16.6 Reading Link, this is an aria labelled by. This is an aria labelled by
OK VoiceOver macOS 13.6Safari 16.6 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 12.5Safari 15.6 Reading Link, this is an aria labelled by. This is an aria labelled by
OK VoiceOver macOS 12.5Safari 15.6 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 11.5Safari 15.0 Reading Link, this is an aria labelled by. This is an aria labelled by
OK VoiceOver macOS 11.5Safari 15.0 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 10.15Safari 14.1 Reading Link, this is an aria labelled by. This is an aria labelled by
OK VoiceOver macOS 10.15Safari 14.1 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 10.14Safari 13.0 Reading Link, this is an aria labelled by. This is an aria labelled by
OK VoiceOver macOS 10.14Safari 13.0 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 10.13Safari 12.1 Reading Link, this is an aria labelled by. This is an aria labelled by
OK VoiceOver macOS 10.13Safari 12.1 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 10.12Safari 10.1.2 Reading Link, this is an aria labelled by. This is an aria labelled by
OK VoiceOver macOS 10.12Safari 10.1.2 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 10.11Safari 9.1.2 Reading Link, this is an aria labelled by
OK VoiceOver macOS 10.11Safari 9.1.2 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 10.10Safari 8.0.6 Reading Link, this is an aria labelled by
OK VoiceOver macOS 10.10Safari 8.0.6 Tabbing Link, this is an aria labelled
OK VoiceOver macOS 10.9Safari 7.0.3 Reading Link, click here, this is an aria labelled by
OK VoiceOver macOS 10.9Safari 7.0.3 Tabbing Link, click here, this is an aria labelled by
OK VoiceOver iOS 17.7Safari iOS 17.7Touch This is an aria labelled by, link
OK VoiceOver iOS 16.6Safari iOS 16.6Touch This is an aria labelled by, link
OK VoiceOver iOS 15.6Safari iOS 15.6Touch This is an aria labelled by, link
OK VoiceOver iOS 14.7Safari iOS 14.7Touch This is an aria labelled by, link
OK VoiceOver iOS 13.3Safari iOS 13.3Touch This is an aria labelled by, link
OK VoiceOver iOS 12.4Safari iOS 12.4Touch This is an aria labelled by, link
OK VoiceOver iOS 11.4Safari iOS 11.4Touch This is an aria labelled by, link
OK VoiceOver iOS 10.3Safari iOS 10.3Touch This is an aria labelled by, link
OK VoiceOver iOS 9.1Safari iOS 9.1Touch This is an aria labelled by link
OK VoiceOver iOS 8.4Safari iOS 8.4Touch This is an aria labelled by link
OK VoiceOver iOS 7.1Safari iOS 7.1Touch This is an aria labelled by link
OK Dolphin SR 15.05IE11 Reading This is an aria labelled by, click here, link
OK Dolphin SR 15.05IE11 Tabbing This is an aria labelled by, link
OK SaToGo 3.4.96.0IE11 Reading link click here
Fail SaToGo 3.4.96.0IE11 Tabbing aria-labelledby ignored click here link

SortSite rules: AccHtmlLinkTextAmbiguous

Test notes

All tests were carried out with screen reader factory settings. JAWS in particular has a wide variety of settings controlling exactly what gets spoken.

Screen readers allow users to interact in different modes, and can produce very different results in each mode. The modes used in these tests are:

  • Reading Content read using the “read next” command in a screen reader
  • Tabbing Content read using the “tab” key in a screen reader
  • Heading Content read using the “next heading” key in a screen reader
  • Touch Content read when touching an area of screen on a mobile device

In the “What the user hears” column:

  • Commas represent short pauses in screen reader voicing
  • Full Stops represent places where voicing stops, and the “read next” or “tab” or “next heading” command is pressed again
  • Ellipsis … represent a long pause in voicing
  • (Brackets) represent voicing that requires a keystroke to hear