Link text replaced by aria-label attribute Screen reader compatibility

ARIA HTML WCAG
Dec 12, 2023

Expected Result: works in a screen reader

Actual Result: causes problems in 14 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: ARIA8

Code used for this test:


		<a href='4567.html' aria-label='this is an aria label'>Click Here</a>
	

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%201464%2015100%2016100%2017100%201893%2019100%2020100%2021100%2022100%2023100%

Change History

Last updated: December 12, 2023

  • Good NVDA with Chrome Stable - OK from NVDA 2018.4 to NVDA 2023.3
  • Better NVDA with IE Better - caused problems in NVDA 2014.1, but now OK in NVDA 2019.2
  • Better NVDA with FF Better - caused problems in NVDA 2014.1, but now OK in NVDA 2023.3
  • Good JAWS with Chrome Stable - OK from JAWS 2018.1811.2 to JAWS 2023.2311.34
  • Good JAWS with IE Stable - OK from JAWS 13.0.852 to JAWS 2019.1912.1
  • Better JAWS with FF Better - caused problems in JAWS 2018.1811.2, but now OK in JAWS 2023.2311.34
  • Good VoiceOver macOS Stable - OK from VoiceOver macOS 10.9 to VoiceOver macOS 13.6
  • Good VoiceOver iOS Stable - OK from VoiceOver iOS 7.1 to VoiceOver iOS 16.6
  • Better WindowEyes with IE Better - caused problems in WindowEyes 8.4, but now OK in 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 2023.3Chrome 120 Reading Link, this is an aria label
OK NVDA 2023.3Chrome 120 Tabbing This is an aria label, link
OK NVDA 2023.3FF 115 Reading Link, this is an aria label
OK NVDA 2023.3FF 115 Tabbing This is an aria label, link
OK NVDA 2023.3Edge 120 Reading Link, this is an aria label
OK NVDA 2023.3Edge 120 Tabbing This is an aria label, link
OK NVDA 2022.2Chrome 105 Reading Link, this is an aria label
OK NVDA 2022.2Chrome 105 Tabbing This is an aria label, link
OK NVDA 2022.2FF 102 Reading Link, this is an aria label
OK NVDA 2022.2FF 102 Tabbing This is an aria label, link
OK NVDA 2022.2Edge 105 Reading Link, this is an aria label
OK NVDA 2022.2Edge 105 Tabbing This is an aria label, link
OK NVDA 2021.2Chrome 94 Reading Link, this is an aria label
OK NVDA 2021.2Chrome 94 Tabbing This is an aria label, link
OK NVDA 2021.2FF 91 Reading Link, this is an aria label
OK NVDA 2021.2FF 91 Tabbing This is an aria label, link
OK NVDA 2021.2Edge 94 Reading Link, this is an aria label
OK NVDA 2021.2Edge 94 Tabbing This is an aria label, link
OK NVDA 2020.2Chrome 86 Reading Link, this is an aria label
OK NVDA 2020.2Chrome 86 Tabbing This is an aria label, link
OK NVDA 2020.2FF 78 Reading Link, this is an aria label
OK NVDA 2020.2FF 78 Tabbing This is an aria label, link
OK NVDA 2020.2Edge 92 Reading Link, this is an aria label
OK NVDA 2020.2Edge 92 Tabbing This is an aria label, link
OK NVDA 2019.2Chrome 79 Reading Link, this is an aria label
OK NVDA 2019.2Chrome 79 Tabbing This is an aria label, link
OK NVDA 2019.2FF 68 Reading Link, this is an aria label
OK NVDA 2019.2FF 68 Tabbing This is an aria label, link
OK NVDA 2019.2IE11 Reading Link, this is an aria label
OK NVDA 2019.2IE11 Tabbing This is an aria label, link
OK NVDA 2018.4Chrome 73 Reading Link, this is an aria label
OK NVDA 2018.4Chrome 73 Tabbing This is an aria label, link
OK NVDA 2018.4FF 60 Reading Link, this is an aria label
OK NVDA 2018.4FF 60 Tabbing This is an aria label, link
OK NVDA 2018.4IE11 Reading Link, this is an aria label
OK NVDA 2018.4IE11 Tabbing This is an aria label, link
OK NVDA 2017.3FF 60 Reading Link, this is an aria label
OK NVDA 2017.3FF 60 Tabbing This is an aria label, link
OK NVDA 2017.3IE11 Reading Link, this is an aria label
OK NVDA 2017.3IE11 Tabbing This is an aria label, link
OK NVDA 2016.2FF 48 Reading Link, this is an aria label
OK NVDA 2016.2FF 48 Tabbing This is an aria label, link
OK NVDA 2016.2IE11 Reading Link, this is an aria label
OK NVDA 2016.2IE11 Tabbing This is an aria label, link
OK NVDA 2015.2FF 40 Reading Link, this is an aria label
OK NVDA 2015.2FF 40 Tabbing This is an aria label, link
OK NVDA 2015.2IE11 Reading Link, this is an aria label
OK NVDA 2015.2IE11 Tabbing This is an aria label, link
Fail NVDA 2014.1FF 28 Reading aria-label ignored link click here
Fail NVDA 2014.1FF 28 Tabbing aria-label ignored Click here, link
Fail NVDA 2014.1IE11 Reading aria-label ignored link click here
Fail NVDA 2014.1IE11 Tabbing aria-label ignored Click here, link
Fail NVDA 2012.1FF 28 Reading aria-label ignored link click here
Fail NVDA 2012.1FF 28 Tabbing aria-label ignored click here link
Fail NVDA 2012.3IE11 Reading aria-label ignored link click here
Fail NVDA 2012.3IE11 Tabbing aria-label ignored click here link
OK JAWS 2023.2311.34Chrome 120 Reading Link, this is an aria label
OK JAWS 2023.2311.34Chrome 120 Tabbing This is an aria label, link
OK JAWS 2023.2311.34FF 115 Reading Link, this is an aria label
OK JAWS 2023.2311.34FF 115 Tabbing This is an aria label, link
OK JAWS 2023.2311.34Edge 120 Reading Link, this is an aria label
OK JAWS 2023.2311.34Edge 120 Tabbing This is an aria label, link
OK JAWS 2022.2207.25Chrome 105 Reading Link, this is an aria label
OK JAWS 2022.2207.25Chrome 105 Tabbing This is an aria label, link
OK JAWS 2022.2207.25FF 102 Reading Link, this is an aria label
OK JAWS 2022.2207.25FF 102 Tabbing This is an aria label, link
OK JAWS 2022.2207.25Edge 105 Reading Link, this is an aria label
OK JAWS 2022.2207.25Edge 105 Tabbing This is an aria label, link
OK JAWS 2021.2107.12Chrome 94 Reading Link, this is an aria label
OK JAWS 2021.2107.12Chrome 94 Tabbing This is an aria label, link
OK JAWS 2021.2107.12FF 91 Reading Link, this is an aria label
OK JAWS 2021.2107.12FF 91 Tabbing This is an aria label, link
OK JAWS 2021.2107.12Edge 94 Reading Link, this is an aria label
OK JAWS 2021.2107.12Edge 94 Tabbing This is an aria label, link
OK JAWS 2020.2008.24Chrome 86 Reading Link, this is an aria label
OK JAWS 2020.2008.24Chrome 86 Tabbing This is an aria label, link
OK JAWS 2020.2008.24FF 78 Reading Link, this is an aria label
OK JAWS 2020.2008.24FF 78 Tabbing This is an aria label, link
OK JAWS 2020.2008.24Edge 92 Reading Link, this is an aria label
OK JAWS 2020.2008.24Edge 92 Tabbing This is an aria label, link
OK JAWS 2019.1912.1Chrome 79 Reading Link, this is an aria label
OK JAWS 2019.1912.1Chrome 79 Tabbing This is an aria label, link
OK JAWS 2019.1912.1FF 68 Reading Link, this is an aria label
OK JAWS 2019.1912.1FF 68 Tabbing This is an aria label, link
OK JAWS 2019.1912.1IE11 Reading Link, this is an aria label
OK JAWS 2019.1912.1IE11 Tabbing This is an aria label, link
OK JAWS 2018.1811.2Chrome 73 Reading Link, this is an aria label
OK JAWS 2018.1811.2Chrome 73 Tabbing Tab, this is an aria label, link
Fail JAWS 2018.1811.2FF 60 Reading aria-label ignored Link, click here
OK JAWS 2018.1811.2FF 60 Tabbing Tab, this is an aria label, link
OK JAWS 2018.1811.2IE11 Reading Link, this is an aria label
OK JAWS 2018.1811.2IE11 Tabbing Tab, this is an aria label, link
OK JAWS 18.0.5038FF 52 Reading Link, this is an aria label
OK JAWS 18.0.5038FF 52 Tabbing Tab, this is an aria label, link
OK JAWS 18.0.5038IE11 Reading Link, this is an aria label
OK JAWS 18.0.5038IE11 Tabbing Tab, this is an aria label, link
OK JAWS 17.0.2619FF 48 Reading Link, this is an aria label
OK JAWS 17.0.2619FF 48 Tabbing This is an aria label, link
OK JAWS 17.0.2619IE11 Reading Link, this is an aria label
OK JAWS 17.0.2619IE11 Tabbing This is an aria label, link
OK JAWS 16.0.4350FF 40 Reading Link, this is an aria label
OK JAWS 16.0.4350FF 40 Tabbing This is an aria label, link
OK JAWS 16.0.4350IE11 Reading Link, this is an aria label
OK JAWS 16.0.4350IE11 Tabbing This is an aria label, link
OK JAWS 15.0.9023FF 29 Reading Link, this is an aria label
OK JAWS 15.0.9023FF 29 Tabbing This is an aria label, link
OK JAWS 15.0.9023IE11 Reading Link, this is an aria label, click here.
OK JAWS 15.0.9023IE11 Tabbing This is an aria label, link
OK JAWS 14.0.9002FF 29 Reading link, this is an aria label
OK JAWS 14.0.9002FF 29 Tabbing This is an aria label, link
OK JAWS 14.0.9002IE11 Reading link, this is an aria label, click here
OK JAWS 14.0.9002IE11 Tabbing This is an aria label, link
Fail JAWS 13.0.852FF 28 Reading aria-label repeated 5 times link, this is an aria label, this is an aria label, this is an aria label, this is an aria label, click here
Fail JAWS 13.0.852FF 28 Tabbing aria-label repeated 5 times This is an aria label, this is an aria label, this is an aria label, this is an aria label, click here link
OK JAWS 13.0.852IE11 Reading link, this is an aria label, click here
OK JAWS 13.0.852IE11 Tabbing This is an aria label, click here link
OK WindowEyes 9.2IE11 Reading Link, this is an aria label
OK WindowEyes 9.2IE11 Tabbing Link, this is an aria label
Fail WindowEyes 8.4IE11 Reading aria-label ignored Link click here
OK WindowEyes 8.4IE11 Tabbing Link, this is an aria label
OK VoiceOver macOS 13.6Safari 16.6 Reading Link, this is an aria label
OK VoiceOver macOS 13.6Safari 16.6 Tabbing Link, this is an aria label
OK VoiceOver macOS 12.5Safari 15.6 Reading Link, this is an aria label
OK VoiceOver macOS 12.5Safari 15.6 Tabbing Link, this is an aria label
OK VoiceOver macOS 11.5Safari 15.0 Reading Link, this is an aria label
OK VoiceOver macOS 11.5Safari 15.0 Tabbing Link, this is an aria label
OK VoiceOver macOS 10.15Safari 14.1 Reading Link, this is an aria label
OK VoiceOver macOS 10.15Safari 14.1 Tabbing Link, this is an aria label
OK VoiceOver macOS 10.14Safari 13.0 Reading Link, this is an aria label
OK VoiceOver macOS 10.14Safari 13.0 Tabbing Link, this is an aria label
OK VoiceOver macOS 10.13Safari 12.1 Reading Link, this is an aria label
OK VoiceOver macOS 10.13Safari 12.1 Tabbing Link, this is an aria label
OK VoiceOver macOS 10.12Safari 10.1.2 Reading Link, this is an aria label
OK VoiceOver macOS 10.12Safari 10.1.2 Tabbing Link, this is an aria label
OK VoiceOver macOS 10.11Safari 9.1.2 Reading Link, this is an aria label
OK VoiceOver macOS 10.11Safari 9.1.2 Tabbing Link, this is an aria label
OK VoiceOver macOS 10.10Safari 8.0.6 Reading Link, this is an aria label
OK VoiceOver macOS 10.10Safari 8.0.6 Tabbing Link, this is an aria label
OK VoiceOver macOS 10.9Safari 7.0.3 Reading link, click here, this is an aria label
OK VoiceOver macOS 10.9Safari 7.0.3 Tabbing link, click here, this is an aria label
OK VoiceOver iOS 16.6Safari iOS 16.6Touch This is an aria label, link
OK VoiceOver iOS 15.6Safari iOS 15.6Touch This is an aria label, link
OK VoiceOver iOS 14.7Safari iOS 14.7Touch This is an aria label, link
OK VoiceOver iOS 13.3Safari iOS 13.3Touch This is an aria label, link
OK VoiceOver iOS 12.4Safari iOS 12.4Touch This is an aria label, link
OK VoiceOver iOS 11.4Safari iOS 11.4Touch This is an aria label, link
OK VoiceOver iOS 10.3Safari iOS 10.3Touch This is an aria label, link
OK VoiceOver iOS 9.1Safari iOS 9.1Touch This is an aria label, link
OK VoiceOver iOS 8.4Safari iOS 8.4Touch This is an aria label, link
OK VoiceOver iOS 7.1Safari iOS 7.1Touch This is an aria label, link
OK Dolphin SR 15.05IE11 Reading This is an aria label, click here, link
OK Dolphin SR 15.05IE11 Tabbing This is an aria label, link
Fail SaToGo 3.4.96.0IE11 Reading aria-label ignored link click here
Fail SaToGo 3.4.96.0IE11 Tabbing aria-label 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