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

Tècnica HTML WCAG 2.2

H57Indicar l'idioma de la pàgina amb lang a l'element html

Nom oficial al W3C: Utilitzar l'atribut d'idioma en l'element html

Versión en castellano

En poques paraules

Cada pàgina ha d'indicar en quin idioma està escrita. Es fa amb l'atribut lang a l'element html, per exemple lang="es" per al castellà. Així el lector de pantalla utilitza la veu i la pronúncia correctes, i el navegador sap com traduir la pàgina o dividir les paraules.

Per què és important

  • Els lectors de pantalla (programes que llegeixen en veu alta el que hi ha a la pantalla) trien la veu segons aquest atribut. Sense l'atribut, poden llegir un text en castellà amb pronúncia anglesa, i no s'entén.
  • Les línies braille i els traductors automàtics també l'utilitzen.
  • El navegador l'utilitza per dividir paraules amb guionet, per a la correcció ortogràfica i per triar tipus de lletra.

Com es fa

  1. Afegiu lang a l'element <html> de la plantilla base: <html lang="es">.
  2. Utilitzeu codis d'idioma vàlids: es, ca, eu, gl, en.
  3. Si hi afegiu el país, separeu-lo amb guionet (es-ES), mai amb guió baix.
  4. Poseu-hi l'idioma real del contingut, no el que portava la plantilla.
  5. En webs amb diversos idiomes, feu que cada versió canviï el valor de manera automàtica.

Exemple pràctic

L'idioma de la pàgina es declara una sola vegada, a la plantilla base del lloc. Pot ser el tema de WordPress, la maqueta del CMS o l'index.html d'una aplicació de React o Vue. Sovint l'element html no té lang o conserva l'anglès de la plantilla.

Així no: Pàgina en castellà sense atribut lang

L'element html no indica l'idioma. El lector de pantalla utilitza la veu que tingui configurada. Si està en anglès o en català, «Pedir cita previa» sona amb la pronúncia d'un altre idioma. Els traductors automàtics i els correctors tampoc no saben en quin idioma és el text.

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Pedir cita previa – Ayuntamiento de Villanueva</title>
</head>
<body>
  <h1>Pedir cita previa</h1>
  <p>Seleccione el trámite y la oficina donde desea ser atendido.</p>
</body>
</html>

Així sí: Idioma principal declarat a l'element html

S'afegeix lang="es" a l'element html. És un codi d'idioma vàlid (norma BCP 47) i coincideix amb l'idioma real del text. El lector canvia a la veu castellana. El navegador tradueix i talla les paraules correctament.

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <title>Pedir cita previa – Ayuntamiento de Villanueva</title>
</head>
<body>
  <h1>Pedir cita previa</h1>
  <p>Seleccione el trámite y la oficina donde desea ser atendido.</p>
</body>
</html>

Com comprovar-ho

Eines del navegador

  1. Obrir les eines de desenvolupament (F12), pestanya Elements. Revisar l'etiqueta d'obertura <html>.
  2. A la pestanya Consola, executar document.documentElement.lang. Ha de retornar "es" o "es-ES". Si retorna una cadena buida, hi falta l'atribut.
  3. Comprovar que el valor coincideix amb l'idioma real del text. No n'hi ha prou que existeixi.

Lector de pantalla (NVDA o VoiceOver)

  1. A NVDA, activar «Canvi automàtic d'idioma (quan sigui possible)» a Preferències > Opcions > Veu.
  2. Posar temporalment la veu de NVDA en un altre idioma, per exemple l'anglès, i carregar la pàgina.
  3. Anar a l'encapçalament amb la tecla H. Sense lang, es pronuncia amb la veu anglesa. Amb lang="es", NVDA canvia a la veu castellana.

Hauria d'anunciar: «Pedir cita previa, encapçalament, nivell 1», amb veu en castellà

Validació automàtica

  1. axe DevTools detecta si hi falta l'atribut (regla html-has-lang). També detecta valors no vàlids com sp o es_ES (regla html-lang-valid). Lighthouse fa la mateixa comprovació.
  2. Cap eina automàtica no detecta un valor vàlid però equivocat, com lang="en" en una pàgina en castellà. Això es revisa manualment.

Errors freqüents en auditories

  • Temes i plantilles amb lang="en" o lang="en-US" fix, utilitzats sense canviar en webs en castellà.
  • Valors que no compleixen la norma BCP 47: lang="sp", lang="es_ES" (amb guió baix) o lang="spanish".
  • Webs amb diversos idiomes en què les pàgines en català, basc o anglès continuen amb lang="es". Sol passar quan l'atribut està escrit a mà a la plantilla.
  • Posar l'atribut a body o en un contenidor, i no a html. Així el títol de la pàgina queda sense idioma.
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica H57 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 l'idioma predeterminat d'un document proporcionant l'atribut lang a l'element html.

Identificar l'idioma del document és important per diversos motius:

  • Permet que el programari de transcripció braille substitueixi els caràcters accentuats per codis de control i insereixi els codis de control necessaris per evitar la creació errònia de contraccions del braille de grau 2.
  • Els sintetitzadors de veu que admeten diversos idiomes es podran orientar i adaptar a la pronúncia i la sintaxi pròpies de l'idioma de la pàgina, i llegiran el text amb l'accent apropiat i la pronúncia correcta.
  • Marcar l'idioma pot beneficiar futurs avenços tecnològics; per exemple, els usuaris que no puguin traduir per si mateixos entre idiomes podran utilitzar màquines per traduir idiomes que no coneixen.
  • Marcar l'idioma també pot ajudar els agents d'usuari a proporcionar definicions mitjançant un diccionari.

Exemples

Definir que el contingut d'un document HTML està en francès

<!doctype html>
<html lang="fr">
<head>
  <meta charset="utf-8">
  <title>document écrit en français</title>
</head>
<body>
  ... document écrit en français ...
</body>
</html>

Proves

Procediment

Examinar l'element html del document.

  1. Comprovar que l'element html té un atribut lang.
  2. 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, i que reflecteix l'idioma principal utilitzat a la pàgina web.

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 H57 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.