diff --git a/understanding/20/language-of-parts.html b/understanding/20/language-of-parts.html index 7d06102ca1..4b771b000c 100644 --- a/understanding/20/language-of-parts.html +++ b/understanding/20/language-of-parts.html @@ -141,14 +141,27 @@
When content is used as the accessible name of an element, the correct language should be specified on that element. This helps assistive technologies pronounce it accurately.
+This link may be announced with an English accent, mispronouncing "Español".
+<a href="/es/"><span lang="es">Español</span></a>
This version correctly applies the Spanish language to the element, ensuring "Español" is pronounced with a Spanish accent.
+<a href="/es/" lang="es"><span>Español</span></a>
When content includes multiple languages, it's acceptable to set the parent element to the primary language, as long as any child elements in a different language have the appropriate language set.
+This example assumes the page’s default language is English. The main text of the link is in English, but it includes the original Italian title of a poem. The Italian portion is correctly marked with lang="it".
+<a href="/la-divina-commedia.html">Read this book: <span lang="it">La Divina Commedia</span></a>
Because "podcast" is part of the vernacular of the immediately surrounding text in the following excerpt, "À l'occasion de l'exposition "Energie éternelle. 1500 ans d'art indien", le Palais des Beaux-Arts de Bruxelles a lancé son premier podcast. Vous pouvez télécharger ce podcast au format M4A et MP3", no indication of language change is required.
This example assumes that the page's default content is in English. The link's title attribute is in English, but the nested span element that contains the word Español has a lang="es" attribute.
This example assumes that the page's default content is in English. The link's title attribute is in English, but the nested span element that contains the words La Divina Commedia has a lang="it" attribute.
<a title="Spanish" href="qa-html-language-declarations-es.html"><span lang="es">Español</span></a>
<a title="Opens in a new window" href="/la-divina-commedia.html">Read this book: <span lang="it">La Divina Commedia</span></a>