This page is in progress -
Why This is Important
Explaining how to pronounce an ambiguous word is accessible to screen reader users and people with reading or learning disabilities.
Pronunciation guides are helpful for understanding uncommon words, abbreviations, heteronyms (words that sound the same but mean different things), and non-English words.
This is accessible to screen reader users because the screen reader reads everything on the page out loud, and it’s important to make sure it’s pronouncing everything correctly. Pronunciation guides are also accessible to people with reading or learning disabilities who may need more support in reading.
This references WCAG criterion 3.1.6 Pronunciation (Level AAA).
How to Implement This
There are a few different ways to implement this that you can choose from, depending on your user needs and context.
Provide the phonetic pronunciation directly after the word
It would help your case if there’s no evidence against you that could be considered inculpatory (in-ˈkəl-pə-ˌtȯr-ē).
My last name is Zhang (pronounced jAHng).
Many dictionary and glossary websites and apps also include an audio file with the phonetic pronunciation. This helps ensure that hearing people can understand how a native speaker would pronounce the term.
Provide pronunciation in a glossary
A glossary can help centralize abbreviation expansions, definitions, and pronunciation all in one place. As an extra accessibility boost, you can link the term directly to where it’s defined in the glossary.
Use the ruby pronunciation element (WIP)
Some accessibility docs recommend using the ruby text element to programmatically set the pronunciation. However, according to some user feedback, this is actually not recommended because screen reader users are used to the quirks of their technology. Overriding the pronunciation might run the risk of confusing people.
If you have additional thoughts about this, please fill out the form below!
How to Test This
Manually assess the content for any complex and ambiguous words that may require a pronunciation guide.
Contribute and Give Feedback
If you would like to provide feedback or contribute content on this resource, please fill out the form below.