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

Tècnica HTML WCAG 2.2

H58Marcar amb lang els fragments escrits en un altre idioma

Nom oficial al W3C: Utilitzar atributs d'idioma per identificar els canvis d'idioma

Versión en castellano

En poques paraules

Quan una pàgina en castellà inclou una frase o un enllaç en un altre idioma, aquest fragment es marca amb l'atribut lang. Per exemple, lang="en" en una cita en anglès. Així el lector de pantalla canvia de veu per a aquest tros i el pronuncia bé.

Per què és important

Un lector de pantalla llegeix la pàgina amb la veu de l'idioma principal. Si en una pàgina en castellà troba una frase en anglès o en català sense marcar, la llegeix amb pronunciació castellana i costa d'entendre-la.

Afecta les persones cegues, les persones amb baixa visió que fan servir la veu i qui utilitza programes de lectura en veu alta per dificultats de lectura. Un cas molt comú és el selector d'idiomes: «English» o «Català» llegits amb veu castellana.

Com es fa

  1. Localitzeu els fragments en un altre idioma: cites, títols d'obres, enllaços del selector d'idiomes, textos en català o en basc.
  2. Afegiu lang a l'element que conté el fragment: <q lang="fr">, <a lang="en">.
  3. Si el fragment no té un element propi, envolteu-lo amb <span lang="…">.
  4. No marqueu noms propis ni paraules ja habituals en l'idioma de la pàgina, com ara «wifi» o «software».
  5. Feu servir codis vàlids, com ara en, ca o fr.

Exemple pràctic

Els canvis d'idioma més habituals són al selector d'idiomes de la capçalera. També en cites, opinions o noms d'obres en un altre idioma dins d'una pàgina en castellà. Per exemple, a la fitxa de producte d'una botiga de vins.

Així no: Selector d'idiomes i cita en francès sense lang

La pàgina és en castellà i res no indica que «English», «Català», «Français» i la cita són en altres idiomes. Encara que el lector de pantalla tingui activat el canvi automàtic d'idioma, els pronuncia amb la veu castellana. La cita costa d'entendre. Per notar-ho cal escoltar la demo amb NVDA o VoiceOver.

Captura de pantalla de l'exemple incorrecte: Selector d'idiomes i cita en francès sense lang
Així es veu l'exemple incorrecte.

La demostració conté, a propòsit, l'error d'accessibilitat que s'explica.

Mostra el codi de l'exemple incorrecte
<style>
  .idiomas { list-style: none; padding: 0; display: flex; gap: 16px; }
  .idiomas a { color: #744E9A; }
</style>
<nav aria-label="Idiomas">
  <ul class="idiomas">
    <li><a href="#" aria-current="page">Español</a></li>
    <li><a href="#">Català</a></li>
    <li><a href="#">English</a></li>
    <li><a href="#">Français</a></li>
  </ul>
</nav>
<h1>Crianza 2021, D. O. Jumilla</h1>
<p>En el concurso internacional de Burdeos, el jurado lo describió como
  <q>un vin d'une grande élégance</q>.</p>

Així sí: Cada canvi d'idioma marcat amb lang

Cada enllaç del selector porta lang amb l'idioma del seu text. També porta hreflang amb l'idioma de la pàgina de destinació. La cita porta lang="fr". El lector canvia de veu en aquests fragments i torna al castellà en acabar.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<style>
  .idiomas { list-style: none; padding: 0; display: flex; gap: 16px; }
  .idiomas a { color: #744E9A; }
</style>
<nav aria-label="Idiomas">
  <ul class="idiomas">
    <li><a href="#" aria-current="page">Español</a></li>
    <li><a href="#" lang="ca" hreflang="ca">Català</a></li>
    <li><a href="#" lang="en" hreflang="en">English</a></li>
    <li><a href="#" lang="fr" hreflang="fr">Français</a></li>
  </ul>
</nav>
<h1>Crianza 2021, D. O. Jumilla</h1>
<p>En el concurso internacional de Burdeos, el jurado lo describió como
  <q lang="fr">un vin d'une grande élégance</q>.</p>

Com comprovar-ho

Lector de pantalla (NVDA o VoiceOver)

  1. A NVDA, activar «Canvi automàtic d'idioma (quan sigui possible)» a Preferències > Opcions > Veu. Comprovar que hi ha veus instal·lades per a aquests idiomes.
  2. Recórrer el selector amb Tab i llegir el paràgraf amb les fletxes.
  3. Comprovar que cada fragment en un altre idioma sona amb la seva veu. El text en castellà ha de tornar a la veu castellana.

Hauria d'anunciar: «English, enllaç», amb veu anglesa

Eines del navegador

  1. Obrir les eines de desenvolupament (F12), pestanya Consola.
  2. Executar [...document.querySelectorAll('[lang]')].map(e => e.lang + ': ' + e.textContent.trim()). Mostra tots els fragments marcats, amb el seu idioma.
  3. Comparar aquesta llista amb el text visible. Buscar fragments en un altre idioma que faltin.

Validació automàtica

  1. axe DevTools comprova que els valors de lang dins de la pàgina són codis vàlids (regla valid-lang).
  2. No detecta text en un altre idioma sense marcar. Tampoc un codi vàlid posat a un idioma equivocat. Això es revisa llegint la pàgina.

Errors freqüents en auditories

  • Selectors d'idioma sense lang en cada nom d'idioma, o fets només amb banderes.
  • Marcar amb lang noms propis o paraules ja habituals en l'idioma de la pàgina (software, màrqueting, wifi). No cal: el criteri 3.1.2 els exceptua.
  • Textos alternatius o aria-label en un altre idioma sense lang al seu element. També es llegeixen amb la veu equivocada.
  • Codis d'idioma no vàlids, com ara lang="cat" o lang="en_GB". O lang="uk" per a l'anglès britànic: uk és ucraïnès.
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica H58 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 identificar clarament qualsevol canvi d'idioma dins d'una pàgina mitjançant l'atribut lang.

Els valors permesos per a l'atribut lang s'indiquen en els recursos citats més avall. Les etiquetes d'idioma fan servir un codi principal per indicar l'idioma i subcodis opcionals (separats per guions) per indicar variants de l'idioma. Per exemple, l'anglès s'indica amb el codi principal "en"; l'anglès britànic i l'anglès estatunidenc es poden distingir amb "en-GB" i "en-US", respectivament. L'ús del codi principal és important per a aquesta tècnica. L'ús de subcodis és opcional, però pot ser útil en determinades circumstàncies.

Exemples

Ús de l'atribut lang per definir una cita escrita en alemany

<blockquote lang="de">
  <p>
    Da dachte der Herr daran, ihn aus dem Futter zu schaffen,
    aber der Esel merkte, daß kein guter Wind wehte, lief fort
    und machte sich auf den Weg nach Bremen: dort, meinte er,
    könnte er ja Stadtmusikant werden.
  </p>
</blockquote>

Proves

Procediment

Per a cada element del document:

  1. Comprovar que l'idioma humà del contingut de l'element és el mateix que l'idioma heretat per l'element segons s'especifica a HTML: els atributs lang i xml:lang.

Per a cada atribut lang del document:

  1. Comprovar que el valor de l'atribut lang s'ajusta a BCP 47: Tags for Identifying Languages; Matching of Language Tags o al seu successor.
  2. Comprovar que el codi d'idioma correspon a l'idioma del contingut al qual s'aplica.

Resultats esperats

  • Totes les comprovacions anteriors 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 H58 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.