Tècnica HTML WCAG 2.2
H62Indicar la pronunciació amb l'element ruby
Nom oficial al W3C: Utilitzar l'element ruby
En poques paraules
En alguns idiomes, com el japonès o el xinès, una mateixa paraula escrita es pot llegir de diverses maneres i significar coses diferents. L'element ruby afegeix al costat del text una petita nota amb la seva pronunciació. Així qui llegeix sap com es pronuncia i què vol dir.
Per què és important
En japonès, molts caràcters (kanji) tenen diverses lectures. Qui n'està aprenent, els infants o les persones amb dificultats de lectura poden no saber com es pronuncia una paraula. Sense aquesta ajuda no entenen la frase.
El criteri 3.1.6 (nivell AAA) demana una manera de conèixer la pronunciació quan, sense aquesta, el significat és ambigu. L'element ruby posa la pronunciació al costat del text, visible per a tothom i marcada en el codi.
Com es fa
- Envolteu la paraula amb
<ruby>. - Després de la paraula, escriviu-ne la pronunciació dins de
<rt>. En japonès sol anar en hiragana. - Afegiu
<rp>amb parèntesis al voltant delrt. Si el navegador no admet ruby, mostrarà la pronunciació entre parèntesis. - Feu servir ruby només on la pronunciació sigui difícil o canviï el significat. No cal en cada paraula.
- Indiqueu l'idioma del text amb
lang, per exemplelang="ja".
Com comprovar-ho
- Localitzeu les paraules la lectura de les quals és ambigua o difícil.
- Comproveu que a la pantalla apareix la seva pronunciació a sobre o al costat.
- Amb les eines del navegador (F12), comproveu que està marcada amb
<ruby>i<rt>. - Comproveu que hi ha
<rp>amb parèntesis per als navegadors que no l'admeten.
Exemple
El nom de Tòquio en japonès amb la seva lectura en hiragana a sobre.
<p lang="ja">
<ruby>東京<rp>(</rp><rt>とうきょう</rt><rp>)</rp></ruby>に住んでいます。
</p>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica H62 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.
Aplicabilitat
HTML
Descripció
L'objectiu d'aquesta tècnica és utilitzar l'anotació ruby per proporcionar informació sobre la pronunciació i el significat d'una seqüència de text el significat de la qual ve determinat per la seva pronunciació.
Hi ha molts idiomes en què una seqüència de text pot significar coses diferents segons com es pronunciï. Això és habitual en les llengües de l'Àsia oriental, així com en hebreu, àrab i altres idiomes; també passa en anglès i en altres llengües de l'Europa occidental.
L'anotació ruby permet a l'autor anotar un «text base», proporcionant una guia de pronunciació i, en alguns casos, també una definició. El ruby s'utilitza habitualment per a textos en japonès i en altres llengües de l'Àsia oriental.
Hi ha dos tipus de marcatge ruby: simple i complex. El marcatge ruby simple s'aplica a una seqüència de text, com ara una paraula o una frase completa. Aquesta es coneix com a text «base» (element rb). L'anotació ruby que indica com s'ha de pronunciar el terme (l'element rt, o text ruby) es mostra amb una font més petita. (El terme «ruby» prové d'una font petita que s'utilitzava amb aquesta finalitat en els textos impresos.) El text ruby se sol mostrar a sobre del text base o immediatament abans, és a dir, just a sobre del text horitzontal o just a la dreta del text vertical. De vegades, en japonès s'utilitza el ruby per donar el significat del text al costat del text base oposat (visualment) al de l'anotació fonètica. El marcatge ruby simple també ofereix una opció de «contingut alternatiu» (fallback) per als agents d'usuari que no admeten marcatge ruby (és a dir, agents d'usuari que no admeten HTML).
El marcatge ruby complex permet dividir el text base en unitats més petites, cadascuna de les quals es pot associar amb una anotació ruby independent. El marcatge ruby complex no admet l'opció de contingut alternatiu.
L'anotació ruby és poc habitual en idiomes com l'hebreu, en què les fonts Unicode poden incloure signes diacrítics que transmeten la pronunciació. També és poc habitual en anglès i en les llengües europees.
Nota: el motiu principal per indicar la pronunciació mitjançant ruby o qualsevol altre mitjà és fer que el contingut sigui accessible per a les persones amb discapacitat que podrien llegir i comprendre l'idioma del contingut si se'ls proporcionés informació sobre la pronunciació. No cal proporcionar informació sobre la pronunciació per a les persones que no estan familiaritzades amb l'idioma del contingut.
Exemples
Marcatge ruby que proporciona informació de pronunciació per a una sigla
Aquest exemple utilitza l'anotació ruby per donar la pronunciació de la sigla (acrònim) formada per les primeres lletres de les paraules Web Content Accessibility Guidelines. Les lletres WCAG són la base (l'element rb), i la informació de pronunciació es mostra mitjançant el text ruby (l'element rt). L'element de parèntesi ruby rp s'utilitza perquè els agents d'usuari que no admeten anotacions ruby indiquin que el text de l'element rt proporciona la informació de pronunciació. La informació de pronunciació es mostra entre parèntesis immediatament després del text base. (Els agents d'usuari que admeten ruby no mostren els parèntesis.)
<p>When we talk about these guidelines, we often just call them
<ruby>
<rb>WCAG</rb>
<rp>(</rp>
<rt>Wuh-KAG</rt>
<rp>)</rp>
</ruby>.
</p>
Anotació ruby per al japonès
El següent és un exemple en japonès. En japonès, el ruby s'utilitza per donar la lectura dels caràcters han (kanji). L'element de parèntesi ruby rp s'utilitza perquè els agents d'usuari que no admeten anotacions ruby indiquin que el text de l'element rt proporciona la informació de pronunciació. La informació de pronunciació es mostra entre parèntesis immediatament després del text base. (Els agents d'usuari que admeten ruby no mostren els parèntesis.)
<p>
<ruby>
<rb>慶應大学</rb>
<rp>(</rp>
<rt>けいおうだいがく</rt>
<rp>)</rp>
</ruby>
</p>
Proves
Procediment
Per a cada seqüència de text en què s'utilitza una anotació ruby per proporcionar informació de pronunciació:
- Comprovar que un element
rtconté la informació de pronunciació per a cada seqüència de text definida per l'elementrb. - Si s'utilitza marcatge ruby simple, comprovar que l'element
rpés present per indicar als agents d'usuari que no admeten anotacions ruby que el text de l'elementrtproporciona la informació de pronunciació.
Resultats esperats
- Les comprovacions núm. 1 i núm. 2 són certes.
Recursos
- W3C Ruby Annotation (especificació d'anotació ruby del W3C)
- CSS Ruby Annotation Layout Module (mòdul de maquetació d'anotacions ruby de CSS)
- W3C Internationalization Techniques: "Using Ruby Markup" (tècniques d'internacionalització del W3C: ús del marcatge ruby)
-
HTML: l'element
ruby -
HTML: l'element
rp -
HTML: l'element
rt
Com ho comprovem a ADDAW
En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.
Basat en la tècnica H62 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.