Addaw, anar a la pàgina d'inici Donar

Tècnica HTML WCAG 2.2

H62Indicar la pronunciació amb l'element ruby

Nom oficial al W3C: Utilitzar l'element ruby

Versión en castellano

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

  1. Envolteu la paraula amb <ruby>.
  2. Després de la paraula, escriviu-ne la pronunciació dins de <rt>. En japonès sol anar en hiragana.
  3. Afegiu <rp> amb parèntesis al voltant del rt. Si el navegador no admet ruby, mostrarà la pronunciació entre parèntesis.
  4. Feu servir ruby només on la pronunciació sigui difícil o canviï el significat. No cal en cada paraula.
  5. Indiqueu l'idioma del text amb lang, per exemple lang="ja".

Com comprovar-ho

  1. Localitzeu les paraules la lectura de les quals és ambigua o difícil.
  2. Comproveu que a la pantalla apareix la seva pronunciació a sobre o al costat.
  3. Amb les eines del navegador (F12), comproveu que està marcada amb <ruby> i <rt>.
  4. 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ó:

  1. Comprovar que un element rt conté la informació de pronunciació per a cada seqüència de text definida per l'element rb.
  2. 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'element rt proporciona la informació de pronunciació.

Resultats esperats

  • Les comprovacions núm. 1 i núm. 2 són certes.

Recursos

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.

Sol·licitar una auditoria

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.